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What as Provides 


Scope of This Manual 


Audience 




Preface 


This manual is the Programmer’s Reference Manual for as — the assembler for 
Sun-3 workstation running the SunOS operating system, as converts source pro¬ 
grams written in assembly language into a form that the linker utility, ld{\) will 
turn into a runnable program. 

as provides assembly language programmers with a minimal set of facilities to 
write programs in assembly language. Since most programming is done in high- 
level languages, as doesn’t provide any elaborate macro facilities or conditional 
assembly features. It is assumed that the volume of assembly code produced is 
so small that these facilities aren’t required. If they are needed, you can use the 
C preprocessor (see cpp{\)) to provide them. 

This manual describes the syntax and usage of the as assembler for the 
MC68020 and MC68030 microprocessors, the MC68881 floating-point coproces¬ 
sor, and Sun’s Floating-Point Accelerators (FPA and FPA+). The basic format of 
as is loosely based on the Digital Equipment Corporation’s Macro-11 assembler 
described in DEC’S publication DEC-11-OMACA-A-D. It also contains elements 
of the UNIXt PDP-11 as assembler. The instruction mnemonics and effective 
address format are based on a Motorola publication on the MC68000: the 
MACSS MC68000 Design Specification Instruction Set Processor dated June 30, 
1979. 

This is a reference manual as opposed to a treatise on writing in assembly 
language. It assumes that you are familiar with the concepts of machine 


t UNIX is a registered trademark of AT&T. 
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Preface — Continued 


Further Reading 


architecture, the reasons for an assembler, the ideas of instruction mnemonics, 
operands, and effective address modes, and assembler directives. It also assumes 
that you are familiar with the relevant processors, their instruction sets and 
addressing modes, and especially their irregularities. 

Motorola MC68020 32-bit Microprocessor User’s Manual. 

Motorola MC68030 32-bit Microprocessor User s Manual. 

Motorola MC68881 Floating-Point Coprocessor User’s Manual. 







Introduction 


1.1. Using the Assembler 



By convention, the assembly language source code of the program should be in 
one or more files with a . s suffix. Suppose that your program is in two files 
called parts . s and rest. s. To run the assembler, type the command: 


r 

A 

tutorial% as parts.s rest.s 


V_ 

J 


as runs silently (if there are no errors), and generates a file called a . out, unless 
the -o option is used. 

as also accepts several command-line options. These are: 


-o file Place the output of the assembler in file instead of a.out. 

-mSSOlO This is the default on Sun-2 systems. Accept only the MC68010 
instruction set and addressing modes. This also puts the MC68010 
machine type tag into the output file. 

-m68020 This is the default on Sun-3 systems. Accept the full MC68020, 
MC68030, MC68881, and Sun FPA and FPA+ instruction sets and 
addressing modes. Includes the MC68010 instruction set and 
addressing modes as a subset, and also puts the MC68020 machine 
type tag into the output file. 


-k Generate position-independent code as required by 


C - 




cc -pic/-PIC 




7 


Warning Don’t apply the -k flag to hand-coded assembler programs unless they are writ¬ 
ten to be position-independent. 

-O Perform span-dependent instruction resolution over each entire file, 

rather than just over each procedure (see the description of the 
. proc pseudo-operation in Chapter 5). 

-R Make initialized data segments read-only (actually the assembler 

places them at the end of the .text area). 

Warning The -R flag should not be used in any program that uses the . stabx directive. 
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2 Assembly Language Reference 


1.2. Notation 


—L Keep local (compiler-generated) symbols that start with the letter L. 

This is a debugging feature. If the -L option is omitted, the assem¬ 
bler discards those symbols and does not include them in the symbol 
table. 

- j Make all jumps to external symbols ( j sr and jmp) 

PC-relative rather than long-absolute. This is intended for use when 
the programmer knows that the program is short, since it only per¬ 
mits jumps (forward or back) up to 32K bytes long. If there are any 
externals which are too far away, the loader will complain when the 
program is linked, 

—J Suppress span-dependent instruction calculations and force all 

branches and calls to take the most general form. This is used when 
assembly time must be minimized, but program size and running 
time are not important. It must be used by any program that uses the 

.align 4 or. align 8 directives. 

—h Suppress span-dependent instruction calculations and force all 

branches to be of medium length, but all calls to take the most gen¬ 
eral form. This is used when assembly time must be minimized, but 
program size and running time are not important. This option results 
in a smaller and faster program than that produced by the - J option, 
but some very large programs may not be able to use it because of 
the limits of the medium-length branches. 

-d2 This is intended for small stand-alone programs. The assembler 

makes all program references PC-relative and all data references 
short-absolute. Note that the — j option does half this job. 

You should also consult the SunOS Reference Manual entry on as. 


The notation used in this manual is a somewhat modified Backus-Naur Form 
(BNF). A string of characters on its own stands for itself, for example: 



is an occurrence of the literal constant 1983. An element enclosed in < and > 
signs is a nonterminal symbol, and must eventually be defined in terms of some 
other entities. For example, 

- 

<identifier> 

\ _ J 


stands for the syntactic construct called ‘identifier’, which is eventually defined 

in terms of basic objects. A syntactic object followed by an ellipsis: 
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denotes one or more occurrences of <thing>. 
Syntactic objects occurring one after the other, as in: 



simply means an occurrence of first thing followed by second thing. Syntactic 
elements separated by a vertical bar sign (|), as in: 



mean an occurrence of <letter> or <digit> but not both. Brackets and braces 
define the order of interpretation. Brackets also indicate that the syntax 
described by the subexpression they enclose is optional. That is: 



denotes zero or one occurrences of <thing>, while { and } are used for grouping 
so that 



denotes a <thing one> or a <thing two>, followed by a <thing three>. 


I 
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Elements of Assembly Language 


This chapter covers the lexical elements which comprise an assembly language 
program. (Chapter 3 discusses the rules for expression and operand formation.) 
Topics covered in this chapter are: 

□ The character set that the assembler recognizes, 

□ Rules for identifiers and labels, 

o Syntax for numeric constants, 

□ Syntax for string constants, 

□ The assembly location counter. 

An assembly language program is ultimately constructed from characters. Char¬ 
acters are combined to make up lexical elements or tokens of the language. Com¬ 
binations of tokens form assembly language statements, and sequences of state¬ 
ments form an assembly language program. This section describes the basic lexi¬ 
cal elements of as. 

2.1, Character Set as recognizes the following character set: 

□ The letters A through Z and a through z. 

□ The digits 0 through 9 . 

□ The ASCII graphic characters — the printing characters other than letters 
and digits. 

□ The ASCII non-graphics', space, tab, carriage return, and newline (also 
known as linefeed). 

2.2. Identifiers Identifiers are used to tag assembler statements (where they are called labels), as 

location tags for data, and as the symbolic names of constants. 

An identifier in an as program is a sequence of from 1 to 255 characters from the 
set: 

□ Upper case letters A through Z. 

□ Lower case letters a through z. 

□ Digits 0 through 9. 


A su n 
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□ The characters underline (_), period ( . ), and dollar sign ( $). 

The first character of an identifier must not be numeric. Other than that restric¬ 
tion, there are a few other points to note; 

□ All characters of an identifier are significant and are checked in comparisons 
with other identifiers. 

□ Upper case letters and lower case letters are distinct, so that 
kit_of_parts and KIT_OF_PARTS are two different identifiers. 

□ The period (.) and dollar sign ( $) characters are reserved for special pur¬ 
poses (pseudo-ops, for instance) and should not appear in user-defined 
identifiers. 

Here are some examples of legal identifiers: 

- 

Grab_Hold 

Widget 

Pot_of_Message 

MAXNAME 

_ > 


A numeric label is a digit (0 trough 9). As in the case of alphanumeric labels, a 
numeric label assigns the current value of the location counter to the symbol. 
However, several numeric labels with the same digit may be used within the 
same assembly. References of the form nh refer to the first numeric label named 
n Z?ackwards from the reference; nt refers to the first numeric label named n 
/orwards from the reference. 

Local labels are a special form of identifier which are strictly local to a control 
section (see Section 5.4). Local labels provide a convenient means of generating 
labels for branch instructions and such. Use of local labels reduces the possibil¬ 
ity of multiply defined labels in a program, and separates entry point labels from 
local references, such as the top of a loop. Local labels cannot be referenced 
from outside the current assembly unit. Local labels are of the form «$ where n 
is any integer. Valid local labels include: 



1$ 

-. 


27$ 



394$ 


< _ 


_^ 


2.5, Scope of Labels The scope of a label is the ‘distance’ over which it is visible to other parts of the 

program which may reference it. An ordinary label which tags a location in the 
program or data is visible only within the current assembly. An identifier which 
is designated as an external identifier via a . globl directive is visible to other 
assembly units at link time. 

Local labels have a scope, or span of reference, which extends between one ordi¬ 
nary label and the next. Every time an ordinary label is encountered, all previous 


23. Numeric Labels 


2,4. Local Labels 
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local labels associated with the current location counter are discarded, and a new 
local label scope is created. The following example illustrates the scopes of the 
different kinds of labels: 


r - 

first: 

addl 

I — ( 

o 

1 creates a new local label scope 

V 

100$: 

addqw 

bees 

#7,d3 

100$ 

1 first appearance of 100$ 
i branches to the label above 


second: 

andl 

#0x7ff,d4 

1 above 100$ has gone away 


100$: 

empw 

beqs 

dl,d3 

100$ 

1 this is a different 100$ 

1 branches to the previous instruction 


third: 

V_ 

movw 

beqs 

d0,d7 

100$ 

1 now 100$ has gone away again 

1 generates an error message if no 100$ below 

_/ 


The labels first, second, and third all have a scope which is the entire 
source file containing them. The first appearance of the local label 10 0 $ has a 
scope which extends between first and second. 

The second appearance of the local label 10 0 $ has a scope which extends 
between second and third. After the appearance of the label third, the 
branch to 10 0 $ will generate an error message because that label is no longer 
defined in this scope. 

2.6. Constants There are two forms of constants available to as users, namely numeric con¬ 

stants and string constants. All constants are considered absolute quantities 
when they appear in an expression (see Section 3.4 for a discussion on absolute 
and relocatable expressions). 

2.7. Numeric Constants as assumes that any token which starts with a digit is a numeric constant, as 

accepts numeric quantities in decimal (base 10), hexadecimal (base 16), and octal 
(base 8) radices, and floating-point quantities. Numeric constants can represent 
quantities up to 32 bits in length. 

Decimal numbers consist of between one and ten decimal digits (in the range 0 
through 9). The range of decimal numbers is between —2,147,483,648 and 
2,147,483,647. Note that you can’t have commas in decimal numbers even 
though they are shown here for readability. Note also that decimal numbers can’t 
be written with leading zeros, because a numeric constant starting with a zero is 
taken as either an octal constant or a hexadecimal constant, as described below. 

Hexadecimal constants start with the notation Ox or OX (zero-ex) and can then 
have between one and eight hexadecimal digits. The hexadecimal digits consist 
of the decimal digits 0 through 9 and the letters a through f or A through 
F. 

Octal constants start with the digit 0. There can then be from one to 11 octal 
digits (0 through 7) in the number. But note that 11 octal digits is 33 bits, so the 
largest octal number is 037777777777. 
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Floating-point constants must start with #0r or #OR, which may be followed by 
an optional sign and either a number, an infinity or a nan ("not a number"). The 

syntax is 


#0r I #0R} [+ 


-] {<number> | inf | nan} 


where the syntax of a <number> is 


[<digits> [. [<digits>'\} \ . <digits>] [E [+ | -] <digits>'] 

< _ / 


and <digits> is a sequence of decimal digits. 

2.8. String Constants A string is a sequence of ASCII characters, enclosed in quote signs ’ 

Within string constants, the quote sign is represented by a backslash character 
followed by a quote sign. The backslash character itself is represented by two 
backslash characters. Any other character can be represented by a backslash 
character followed by one, two, or three octal digits, or by a backslash followed 
by Ox or OX and a one-, two-, or three-digit hexadecimal constant. The table 
below shows the octal representation of some of the more common non-printing 
characters. 


Character 

Octal 

Hex 

Backspace 

\010 

\0x8 

Horizontal Tab 

\011 

\0x9 

Newline (Linefeed) 

\012 

\0xA 

Formfeed 

\014 

\0xC 

Carriage Return 

\015 

\0xD 


2.9. Assembly Location The assembly location counter is the period character (,). It is colloquially 

Counter known as dot. When used in the operand field of any statement, dot represents 

the address of the first byte of the statement. Even in assembler directives, dot 
represents the address of the start of that assembler directive. For example, if dot 
appears as the third argument in a . long directive, the value placed at that loca¬ 
tion is the address of the first location of the directive — dot is not updated until 
the next machine instruction or assembler directive. For example: 


r - 

Ralph: 

movl . , aO 

1 load value of Ralph into aO 


V_ 



J 


You can reserve storage by advancing dot. For example, the statement 
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Chapter 2 — Elements of Assembly Language 9 



- 

Table: .=.+0x100 

V_> 


reserves 256 bytes (100 hexadecimal) of storage, with the address of the first byte 
as the value of Table. This is exactly equivalent to using . skip (the preferred 
syntax) as follows: 


f 

Table: 

. skip 

0x100 


1 



> 


The value of dot is always relative to the start of the current control section. For 
example, 

- 

. = 0x1000 

V_/ 


doesn’t set dot to absolute location 0x1000, but to location 0x1000 relative to the 
start of the current control section. This practice is not recommended. 
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Expressions 


Expressions are combinations of operands (numeric constants and identifiers) and 
operators, forming new values. The sections below define the operators which 
as provides, then gives the rules for combining terms into expressions. 

3.1. Operators Identifiers and numeric constants can be combined, via arithmetic operators, to 

form expressions, as provides unary operators and binary operators, as 
described below. 

Table 3-1 Unary Operators in Expressions 


Operator 

Function 

Description 

- 

unary minus 

Two’s complement of its argument. 


logical negation 

One’s complement of its argument. 



Table 3-2 Binary Operators in Expressions 


Operator 

Function 

Description 

+ 

addition 

Arithmetic addition of its arguments. 

- 

subtraction 

Arithmetic subtraction of its arguments. 

fc 

multiplication 

Arithmetic multiplication of its arguments. 

/ 

division 

Arithmetic division of its arguments. Note that 
division in as is integer division, which trun¬ 
cates towards zero. 


Each operator works on 32-bit numbers. If the value of a particular term occu¬ 
pies only 8 bits or 16 bits, it is sign extended to a full 32-bit value. 
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3.2. Terms A term is a component of an expression. A term may be any of the following: 

□ A numeric constant, whose 32-bit value is used. The assembly location 
counter, known as dot, is considered a number in this context. 

□ An identifier, 

□ An expression or term enclosed in parentheses ( ). 

Any quantity enclosed in parentheses is evaluated before the rest of the 
expression. This can be used to alter the normal left-to-right evaluation of 
expressions — for example, differentiating between a*b+c and a* (b+c) 
or to apply a unary operator to an entire expression — for example, 

—(a*b+c), 

□ A term preceded by a unary operator. For example, both 
ciouble_plus_ungood and ~double__plus_ungood are terms. 

Multiple unary operators can be used in a term. For example, -—positive 

has the same value as positive. 

3.3. Expressions Expressions are combinations of terms joined together by binary operators. An 

expression is always evaluated to a 32-bit value. 

If the operand requires only a single-byte value (a . byte directive or an addq 

instruction, for example) the low-order eight bits of the expression’s value are 

used. 

, ""n 

If the operand requires only a 16-bit value (a . word directive or a movem 

instruction, for example) the low-order 16 bits of the expression’s value are used. 


Expressions are evaluated left to right with no operator precedence. Thus 




1 + 2*3 


1 .... 

J 


evaluates to 9, not 7. Unary operators have precedence over binary operators 
since they are considered part of a term, and both terms of a binary operator must 

be evaluated before the binary operator can be applied, 

A missing expression or term is interpreted as having a value of zero. In this 
case, an Invalid expression error is generated. 

An Invalid Operator error means that a valid end-of-line character or binary 
operator was not detected after the assembler processed an expression. In partic¬ 
ular, this error is generated if an expression contains an identifier with an illegal 
character, or if an incorrect comment character was used. 

3.4. Absolute^ Relocatable? When an expression is evaluated, its value is either absolute, relocatable, or 

external: 

An expression is absolute if its value is fixed. 

□ An expression whose terms are constants is absolute. 

□ An identifier whose value is a constant via a direct assignment statement is 
absolute. 

Revision A of 27 March, 1990 


Asun 

tnicros>^tems 


and External 

Expressions 








Chapter 3 — Expressions 13 






□ A relocatable expression minus a relocatable term is absolute, if both items 
belong to the same program section. 

An expression is relocatable if its value is fixed relative to a base address, but 
will be adjusted by an offset value when it is linked or loaded into memory. All 
labels of a program defined in relocatable sections are relocatable terms. 

Expressions containing relocatable terms must only have constants added or sub¬ 
tracted to their values. For example, assuming the identifiers widget and 
blivet were defined in a relocatable section of the program, then the following 
demonstrates the use of relocatable expressions: 


Expression 

Description 

widget 

is a simple relocatable term. Its value is an offset from 
the base address of the current control section. 

widget+5 

is a simple relocatable expression. Since the value of 
widget is an offset from the base address of the current 
control section, adding a constant to it does not change 
its relocatable status. 

widget*2 

Not relocatable. Multiplying a relocatable term by a 
constant invalidates the relocatable status. 

2-widget 

Not relocatable, since the expression cannot be linked by 
adding widget’s offset to it. 

widget—blivet 

Absolute, since the offsets added to widget and 
blivet cancel each other out. 


An expression is external (or global) if it contains an external identifier not 
defined in the current program. With one exception, the same restrictions on 
expressions containing relocatable identifiers apply to expressions containing 
external identifiers. The exception is that the expression 


f - 


widget-blivet 


V 

J 


is incorrect when both widget and blivet are external identifiers — you 
cannot subtract two external relocatable expressions. In addition, you cannot 
multiply or divide any relocatable expression. 
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Assembly Language Program Layout 


An as program consists of a series of statements. Several statements can be 
written on one line, but statements cannot cross line boundaries. The format of a 
statement is; 

[< label field >] [ < opcode > [< operand field >] ] 

\ - / 


It is possible to have a statement which consists of only a label field. 

The fields of a statement can be separated by spaces or tabs. There must be at 
least one space or tab separating the opcode field from the operand field, but 
spaces are unnecessary elsewhere. Spaces may appear in the operand field. 

, ^ Spaces and tabs are significant when they appear in a character string (for 

- instance, as the operand of an .ascii pseudo-op) or in a character constant. In 

these cases, a space or tab stands for itself. 

A line is a sequence of zero or more statements, optionally followed by a com¬ 
ment, ending with a < newline> character. A line can be up to 4096 characters 
long. Multiple statements on a line are separated by semicolons. Blank lines are 
allowed. The form of a line is: 


r 


V 


[< statement > [; < statement > ...]][ | < comment > ] 




_/ 


4.1. Label Field 


Labels are identifiers which the programmer may use to tag the locations of pro¬ 
gram and data objects. The format of a <label field> is: 

<identifier>: [ <identifier >: ] . . . 

\ 


If present, a label always occurs first in a statement and must be followed by a 
colon: 


r 


A 

sticky: 

1 label defined here. 


1_ 


J 



15 


Revision A of 27 March, 1990 








16 Assembly Language Reference 


More than one label may appear in the same source statement, each one being 
terminated by a colon: 


presson: grab: hold: 


multiple labels defined here. 


The collection of label definitions in a statement is called the label field. 

When a label is encountered in the program, the assembler assigns fiiat label the 
value of the current location counter. The value of a label is relocatable. The 
symbol’s absolute value is assigned when the program is linked with the system 
linker ld{l). 

4.2. Operation Code Field The operation code (opcode) field of an assembly language statement identifies 

the statement as either a machine instruction or an assembler directive. 

One or more spaces (or tabs) must separate the operation code field from the fol¬ 
lowing operand field in a statement. Spaces or tabs are unnecessary between the 
label and oj^ration code fields, but they are recommended to improve readability 
of the program. 

A machine instruction is indicated by an instruction mnemonic. The assembly 
language statement is intended to produce a single executable machine instruc¬ 
tion. The Gyration of each instruction is described in the Motorola user manuals 
for either the MC68020 or MC68030. Conventions used in as for instmction 
mnemonics are described in Chapter 6 and a complete list of the instructions is 
presented in Appendix B. 

An assembler directive, or pseudo-op, performs some function during the assem¬ 
bly process. It does not produce any executable code, but it may assign space for 
data in a program. 

Note that as expects that all instruction mnemonics in the op-code field are in 

lower case only. Using upper case letters in instruction mnemonics gives rise to 
an error message. 

The names of register operands must also be in lower case only. This behavior 
differs from the case for identifiers, where both upper and lower case letters may 
be used and are considered distinct. 

Many MC68010, MC68020 and MC68030 machine instructions can operate 
upon byte (8-bit), word (16-bit), or long word (32-bit) data. The size that the 
programmer requires is indicated as part of the instruction mnemonic. For 
instance, a movb instruction moves a byte of data, a movw instruction moves a 
16-bit word of data, and a movl instmction moves a 32-bit long word of data. 

In general, the default size for data manipulation instmctions is word. 

Many MC68881 or MC68882 machine instmctions can operate on byte, word or 
long word integer data, on single-precision (32-bit), double-precision (64-bit) or 
extended-precision (96-bit) floating-point data or on packed-decimal (96-bit) 

data. The size required is specified as part of the instmction mnemonic by a trail¬ 
ing "b", "w", "1", "s", "d", "x" or" p", respectively. 
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An alternate coprocessor id can be sf^cified for MC68881 instructions by 
appending @ici to the opcode, such as f add@2. If you don’t do this, the copro¬ 
cessor id specified by the most recent . cpid pseudo-operation is used. (See 
Chapter 5.) 

Similarly, branch instructions can use a long or short offset specifier to indicate 
the destination. So the beq instruction uses a 16-bit offset, whereas the beqs 
uses a short (8-bit) offset. 

Note that this implementation of as provides an extended set of branch instruc¬ 
tions which start with the letter j instead of b. If the programmer uses the j 
forms, the assembler computes the offset size for the instruction. See Section 1,1 
for the assembler options which control this. 

4.3. Operand Field The operand field of an assembly language statement supplies the arguments to 

the machine instruction or assembler directive. 

as makes a distinction between the <operandfield> and individual <operands> 
in a machine instmction or assembler directive. Some machine instmctions and 
assembler directives require two or more arguments, and each of these is referred 
to as an “operand”. 


In general, an operand field consists of zero or more operands, and in all cases, 
operands are separated by commas. In other words, the format of an <operand 
field> is: 


f — 





[<operand> [,<operand> ] . 

. ] 


k_ 



J 


The general format of the operand field for machine instructions is the same for 
all instructions, and is described in Chapter 6. The format of the operand field 
for assembler directives depends on the directive itself, and is included in the 
directive’s description in Chapter 5 of this manual. 

Depending upon the machine instmction or assembler directive, the operand field 
consists of one or more operands. The kinds of objects which can form an 
operand are: 

□ Register 

□ Register pairs 

□ Addresses 

□ String constants 

□ Floating-point constants 

□ Register lists 

□ Expressions 

Register operands in a machine instmction refer to the machine registers of the 
processor or coprocessor. 
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Note that register names must be in lower case; as does not recognize register 
names in upper case or a combination of upper case and lower case. 

Expressions are described in Chapter 3, address operands in Section 6.3, and con¬ 
stants in Chapter 2. 

4.4. Comment Field as provides a means for the programmer to place comments in the source code. 

There are two ways of representing comments. 


A line whose first non-whitespace character is the hash character (#) is con¬ 
sidered a comment. This feature is handy for passing C preprocessor output 
through the assembler. For example, these lines are comments: 


f 



# This 

is a comment line. 

# And this one is also a comment line. 


1_ 


J 


The other way to introduce a comment is when a comment field appears on a line 
with a statement. The comment field is indicated by the presence of the vertical 
bar character ( |) after the source statement. 

The comment field consists of all characters on a source line including and fol¬ 
lowing the comment character. The assembler ignores the comment field. Any 
character may appear in the comment field, with the obvious exception of the 
<newline> character, which starts a new line. 


An assembly language source line can consist of just a comment field. For exam¬ 
ple, the two statements below are quite acceptable to the assembler: 


f 


1 This is a comment field. 


1 So is this. 


V_ 

J 


4.5. Direct Assignment A direct assignment statement assigns the value of an arbitrary expression to a 

Statements specified identifier. The format of a direct assignment statement is: 


f 

\ 

<identifier> = <expression> 


1_ 

J 


Examples of direct assignments are: 


f 

. ^ 

vect_size 

= 4 

vectors 

= OxFFFE 

vectorb 

= vectora--vect_size 

CRLF 

= OxODOA 

dtemp 

= dO 1 use register dO as temporary 

V_ 

J 


Any identifier defined by direct assignment may be redefined later in the pro¬ 
gram, in which case its value is the result of the last previous such statement. 
This is analogous to the SET operation found in other assemblers. 
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A local identifier may be defined by direct assignment, though this doesn’t make 
much sense. 

Register identifiers may not be redefined. 

An identifier which has already been used as a label may not be redefined, since 
this would be tantamount to redefining the address of a place in the program. In 
addition, an identifier which has been defined in a direct assignment statement 
cannot later be used as a label. Both situations give rise to assembler error mes¬ 
sages. 

If the <expression> in a direct assignment is absolute, the identifier is also abso¬ 
lute, and may be treated as a constant in subsequent expressions. If the <expres- 
sion> is relocatable, however, the < identifier > is also relocatable, and it is con¬ 
sidered to be declared in the same program section as the expression. 


If the <expression> contains an external identifier, the identifier defined by direct 
assignment is also considered external. For example: 


r 


> 

.globl X 

1 X is declared as external identifier 


holder = X 

1 holder becomes an external identifier 


1 


J 


assigns the value of X (zero if it is undefined) to holder and makes holder an 
external identifier. External identifiers may be defined by direct assignment. 

4.6. Self-Modifying Code If you intend to write programs that must modify their own code, you must be 

able to flush the processor’s cache to make sure that the code the program has 
just modified is not overwritten by a cache fill. 

Flushing the cache is done by using a special trap to request SunOS to do the 
operation; trap #2. (Note that this is not system call #2, which is trap #0 with the 
value 2 in register dO.) Here are some sample definitions and usage relating to 
cache flushing: 
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r 






. long 

syscall 

1 0x20 

Trap instruction 0 

(system call) 


. long 

badtrap 

1 0x21 

Trap instruction 1 

(monitor breakpoint) 


. long 

flush 

i 0x22 

Trap instruction 2 

(cache flush) 



.globl flush 





flush: 






movl #ICACHE 

CLEAR+ICACHE ENABLE+DCACHE CLEAR+DCACHE__ENABLE,dO 


move dO^cacr 


1 clear (and 

enable) the cache 



rte 





#define 

ICACHE BURST 


0x0010 



#define 

ICACHE ENABLE 


0x0001 + ICACHE_BURST 


#define 

ICACHE_FREEZE 


0x0002 



#define 

ICACHE CLRENTRY 


0x0004 



#define 

ICACHE_CLEAR 


0x0008 



#define 

DCACHE BURST 


0x1000 



#define 

DCACHE ENABLE 


0x2100 + DCACHE BURST 


#define 

DCACHE FREEZE 


0x0200 



#define 

DCACHE CLRENTRY 


0x0400 



#define 

DCACHE_CLEAR 


0x0800 



1 _ 





J 


You call the trap from a program with 





■ 




■ 


Please note that this sort of operation could have dire consequences if not prop¬ 
erly used. 
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Table 5-1 


Assembler Directives 


Assembler directives are also known as pseudo operations or pseudo-ops. 
Pseudo-ops are used to direct the actions of the assembler, and to achieve effects 
such as generating data. The pseudo-ops available in as are listed in Table 5-1 
below. 


Assembler Directives 


Pseudo- 

Operation 

Description 

. ascii 

Generates a sequence of ASCII characters. 

.asciz 

Generates a sequence of ASCII characters, terminated by a zero byte. 

.byte 

Generates a sequence of bytes in data storage. 

.bytez 

Generates a sequence of bytes in data storage initialized to zero. 

. word 

Generates a sequence of words in data storage. 

. long 

Generates a sequence of long words in data storage. 

.single 

Generates a sequence of single-precision floating-point constants in 
data storage. 

.double 

Generates a sequence of double-precision floating-point constants in 
data storage. 

.text 

Specifies that the following generated code be placed in the text control 
section until further notice. 

. data 

Specifies that the following generated code be placed in the data con¬ 
trol section until further notice. 

.datal 

Specifies that the following generated code be placed in the datal con¬ 
trol section until further notice. 

.data2 

Specifies that the following generated code be placed in the datal con¬ 
trol section until further notice. 

.bss 

Specifies that space will be reserved in the bss control section until 
further notice. 

.globl 

Declares an identifier as global (external). 

. comm 

Declares the name and size of a common area. 
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Table 5-1 Assembler Directives — Continued 


Pseudo- 

Operation 

Description 

.Icomm 

Reserves a specified amount of space in the bss control section. 

. skip 

Advances the current location counter by a specified amount. 

.align 

Forces current location counter to next one-, two-, four- or eight-byte 
boundary. 

. even 

Forces current location counter to next word (even-byte) boundary. 

.stabx 

Builds special symbol table entries. These directives are included for 
the benefit of compilers which generate information for the symbolic 
debuggers dbx and dbxtool. 

.proc 

Separates procedures for faster span-dependent instruction resolution. 

. cpid 

Assigns a coprocessor number. 


These assembler directives are discussed in detail in the following sections. 


5.1. .ascii — Generate 
Character Data 


The .ascii directive translates character strings into their ASCII equivalents 
for use in the program. The format of the .ascii directive is: 


/- 


- N 

[<label>'.'\ .ascii 

" <character string> " 


1_ 


J 


< character string> contains any character or escape sequence which can appear 
in a character string. Obviously, a newline must not appear within the character 
string. A newline can be represented by the escape sequence \012. The following 
examples illustrate the use of the .ascii directive: 


Octal Code Generated: 


150 

145 

154 

15 4 

157 

040 

164 

150 

145 

162 

145 


127 

141 

162 

156 

151 

156 

147 

055 

007 

007 

040 

012 

141 

142 

143 

144 

145 

146 

147 







Statement: 

ascii "hello there" 

ascii "Warning—\007\007 \012' 

ascii "abcdefg" 
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5.2. .asciz —Generate 
Zero-T er mlnated 
Sequence of Character 
Data 


The .asciz directive is equivalent to the .ascii directive except that a zero 
byte is automatically appended as the final character of the string. This feature is 
intended for generating strings which C programs can use. The following exam¬ 
ples illustrate the use of the .asciz directive: 


Octal Code Generated: 


Statement: 


110 

145 

154 

127 

157 

162 

124 

150 

105 

145 

141 

164 

117 

115 

160 

040 

163 

164 

145 

163 

040 

151 

156 

041 


154 

157 

040 

144 

041 

000 

040 

107 

162 

040 

120 

122 

153 

151 

156 

162 

151 

153 

141 

147 

141 

000 




.asciz "Hello World!" 


.asciz "The Great PROMpkin strikes again!" 


5.3. Directives to Generate The .byte, .word, .long, . single, and . double directives reserve 
Data storage locations and initialize them with specified values. 

The format of the various forms of data generation statements are: 


f 

[ <label> : ] 

-byte 

[ <expression> ] 

[, <expression> ] . . . 

> 

[ <label> : ] 

.bytez 

< number > 



[ <label> : ] 

. word 

[ <expression> ] 

[ f <expression> ] . . . 


[ <label> : ] 

. long 

[ <expression> ] 

[, <expression> ] . . . 


[ <label> : ] 

.single 

[ <expression> ] 

[, <expression> ] . . . 


[ <label> : ] 

.double 

[ <expression> ] 

[, <expression> ] . . . 


k 




> 


The . byte directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to the low-order 8 bits of the corresponding 
expression’s value. 

The .bytez directive reserves <number> bytes (8 bits), and initializes them to 
zero. 

The . word directive reserves one word (16 bits) for each expression’s value in 
the operand field, and initializes it to the low-order 16 bits of the corresponding 
expression’s value. 

The . long directive reserves one long word (32 bits) for each expression in the 
operand field, and initializes it to the value of the corresponding expression’s 
value. 
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The . single directive reserves one long word for each expression in the 
operand field, and initializes it to the low-order 32 bits of the corresponding 
expression’s value. 

The . double directive reserves a pair of long words for each expression in the 
operand field, and initializes them to the value of the corresponding expression’s 
value. 

Multiple expressions can appear in the operand field of the . byte, .word, 
.long, .single, and . double directives. Multiple expressions must be 
separated by commas. 

5.4. Directives to Switch These statements .text, .data, .bss, .datal,and .data2, change the 

Location Counter ‘control section’ where assembled code is loaded. 

as (and the system linker) view programs as divided into three distinct sections 
or address spaces: 


Space 

Description 

text 

The address space where the executable machine instructions are 
placed. 

data 

The address space where initialized data is placed. The assem¬ 
bler actually knows about three data sections, namely, data, 
datal, and data2. The second and third data areas are mainly for 
the benefit of compilers and are of minimal interest to the assem¬ 
bly language programmer. 

If the -R option is coded on the as command line, it means that 
the initialized data should be considered read-only. It is actually 
placed at the end of the text area. 

bss 

The address space where the uninitialized data areas are placed. 
Also, see the . Icomm directive described below. 


For historical reasons, the different areas are frequently referred to as ‘control 
sections’ (csects for short). 

These sections are equivalent as far as as is concerned, with the exception that 
no instructions or data are generated for the bss section — only its size is com¬ 
puted and its symbol values are output. 

During the first pass of the assembly, as maintains a separate location counter 
for each section. Consider the following code fragments: 
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code: 

. text 

movw 

dl,d2 

1 place next instruction 

1 in text section 

-\ 

grab: 

. data 
. long 

27 

1 now generate data in 

1 data section 


more: 

. text 

addw 

d2,dl 

I now revert to text 

1 section 


hold: 

— 

. data 
.byte 

4 

1 now back to data section 

J 


During the first pass, as creates the intermediate output in two separate chunks: 
one for the text section and one for the data section. In the text section, code 
immediately precedes more; in the data section, grab immediately precedes 
hold. At the end of the first pass, as rearranges all the addresses so that the 
sections are sent to the output file in the order; text, data and bss. 

The resulting output file is an executable image file with all addresses correctly 
resolved, with the exception of undefined . globl’s and . comm’s. 

For more information on the format of the assembler’s output file, consult the 
a.out{5) entry in the System Programmer s Reference Manual. 

5.5. .skip — Advance 
Location Counter 


5.6. . Icomm -— Reserve 
Space in bss Area 


the The . skip directive reserves storage by advancing the current location counter 
a specified amount. The format of the .skip directive is: 


r 



[ <label> : ] 

.skip <size> 


V_ 




where <size> is the number of bytes by which the location counter should be 
advanced. The . skip directive is equivalent to performing direct assignment 
on the location counter. For instance, a .skip directive like this: 


r 



Table: 

.skip 1000 


V_ 


_/ 


reserves 1000 bytes of storage, with the value of Table equal to the address of 
the first byte. 


The . Icomm directive is a compact way to get a specific amount of space 
reserved in the bss area. The format of the . Icomm directive is: 


r 


.Icomm <name> ,<size> 


V_ 

J 


where <name> is the name of the area to reserve, and <size> is the number of 
bytes to reserve. The . Icomm directive specifically reserves the space in the bss 
area, regardless of which location counter is currently in effect. 

A . Icomm directive like this: 
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f - 


A 

.Icomm 

lower_forty^1200 


V 


J 


is equivalent to these directives: 

- 

.bss I switch to .bss area 

lower_forty: .skip size 

revert to previous control section 

\ _ ___ _______ j 


5.7. . globl ■— Designate A program may be assembled in separate modules, and then linked together to 

an External Identifier form a single executable unit. See the ld(l) command in the SunOS Reference 

Manual. 

External identifiers are defined in each of these separate modules. An identifier 
which is defined (given a value) in one module may be referenced in another 

module by declaring it external in both modules. 

There are two forms of external identifiers, namely, those declared with the 
. globl directive and those declared with the . comm directive. The . comm 
directive is described in the next section. 

External symbols are declared with the . globl assembler directive. The format 

is: 

---- _ 

.globl <symbol> [, <symbol>] . . . 

v_________ J 


For example, the following statements declare the array TABLE and the routine 
SRCH as external symbols, and then define them as locations in the current con¬ 
trol section: 


f 

.globl 

TABLE,SRCH 

A 

TABLE: 

.word 

o 

o 

o 

o 

o 


SRCH: 

movw 

TABLE,dO 



etc. 



1 



J 


5.8. . comm — Define Name 
and Size of a Common 
Area 


The . comm directive declares the name and size of a common area, for compati¬ 
bility with FORTRAN and other languages which use common. The format of the 
. comm statement is: 




A 


.comm <name> f <constant expression> 




J 


where <name> is the name of the common area, and <constantexpression> is 
the size of the common area. The . comm directive implicitly declares the 
identifier <name> as an external identifier. 

as does not allocate storage for common symbols; this task is left to the linker. 
The linker computes the maximum declared size of each common symbol (which 
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may appear in several load modules), allocates storage for it in the final bss sec¬ 
tion, and resolves linkages. If, however, <name> appears as a global symbol 
(label) in any module of the program, all references to <name> are linked to it, 
and no additional space is allocated in the bss area. 


5.9. .align- —Force 
Location Counter to 
Particular Byte 
Boundary 


5.10. . even — Force 

Location Counter to 
Even Byte Boundary 


The .align directive advances the location counter to the next one-, two-, four- 
or eight-byte boundary, if it is not currently on such a boundary. Intervening 
bytes are filled with zeros. The format of the . align directive is: 


f 

-N 

.align <size> 


V_ 

) 


where <size> must be an assembler expression which evaluates to 1,2,4 or 8. 

If you choose to use the . align 4 or align 8 directives, you must use the - 
J flag when you assemble your program; the assembler does span-dependent 
instruction resolution, and using align 4 or align 8 changes the address of 
jump targets. 

This directive is necessary because 

□ Word and long word data values must lie on even-byte boundaries 

□ Machine instructions must start on even-byte boundaries 

□ The MC68020 and MC68030 operate much more efficiently if word and 
long word data are on even-byte and four-byte boundaries, respectively. 

The .even directive advances the location counter to the next even-byte boun¬ 
dary, if its current value is odd. This directive is provided because word and long 
word data values must lie on even-byte boundaries, and also because machine 
instmctions must start on even-byte boundaries. . even is equivalent to 
. align 2. 


! 


A 


. even 




_ ) 


5.11. .stabx — Build 

Special Symbol Table 
Entry 


The . stabA: directives are provided for the use of compilers which can generate 
information for the symbolic debuggers dbx and dbxtool. The directives 
. stabs, . stabd, and . stabn build various types of symbol table entries. 

The . stabx directives have the following forms: 


f ^ 

.stabs name, type, 0, desc, value 

.stabn type, 0, desc, value 

< _ 



or 
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--- 

.stabd type,0,desc 

V_____________^ 


5.12. . proc — Separate 
Procedures for Span- 
Dependent 
Instruction 

Resolution 


L .stabs directives are used to describe types, variables, procedures, and so on, 

while . stabn directives convey information about scopes and the mapping 
from source statements to object code. 

A . stabd directive is identical in meaning to a corresp3nding . stabn direc¬ 
tive with the value field set to (dot), which the assembler uses to mean the 
current location. Most of the needed information, for example symbol name and 
type structure, is contained in the name field. The type field identifies the type of 
symbolic information, for example source file, global symbol, or source line. 

The desc field sf^cifies the number of bytes occupied by a variable or type or the 
nesting level for a scope symbol. The value field specifies an address or an 
offset. 

The -R flag conflicts with the . stabx directive because there is no appropriate 
data type being set up for static variables. 

The .proc directive separates procedures for span-dependent instruction resolu¬ 
tion. In its absence the assembler does span-dej^ndent instruction resolution 
over entire files. If .proc is used, the resolution is done between occurrences of 

the directive and between either end of the file and its nearest occurrences. Since 
the algorithm used requires more than linear time, using .proc can save 
significant time for large assemblies. Branch instructions must not cross .proc 
directives, although calls may. 


r 

> 

.proc 


V______ 

J 


5.13. . cpid ■— Name 

Default Coprocessor 

ID 


The . cpid directive gives the assembler a coprocessor id value to use for 

MC68881 instructions that don’t have an explicit coprocessor id given. The 

form of the directive is 


f 

A 

.cpid <id> 


V 

J 


If no . cpid directive is given in a program, a value of 1 is assumed. Since no 
Sun system currently has more than one coprocessor, you don’t need to use this 
directive. 
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Instructions and Addressing Modes 


This chapter describes the conventions used in as to specify instruction 
mnemonics and addressing modes. The information in this chapter is specific to 
the machine instmctions and addressing modes of the MC68010, MC68020, and 
MC68030 microprocessors and the MC68881 and MC68882 coprocessors. See 
Appendix C for information on the Sun FPA and FPA+’s instruction sets and 
addressing modes. 

6.1. Instruction Mnemonics The instruction mnemonics that as uses are based on the mnemonics described 

in the relevant Motorola processor manuals. However, as deviates from them in 
several areas. 

Most of the MC68010, MC68020 and MC68030 instructions can apply to byte, 
word or long operands. Instead of using a qualifier of . b, . w, or , 1 to indicate 
byte, word, or long as in the Motorola assembler, as appends a suffix to the nor¬ 
mal instruction mnemonic, thereby creating a separate mnemonic to indicate 
which length operand was intended. 

For example, there are three mnemonics for the or instmction: orb, orw, and 
or 1, meaning or byte, or word, and or long, respectively. 

Instruction mnemonics for instructions with unusual opcodes may have addi¬ 
tional suffixes. Thus in addition to the normal add variations, there also exist 
addqb, addqw and addql for the add quick instruction. 

Branch instructions come in two flavors for the MC68010, byte (or short) and 
word, and an additional flavor, long, for the MC68020. Append the suffix .s to 
the word mnemonic to specify the short version of the instruction. For example, 
beq refers to the word version of the Branch if Equal instruction, beqs refers to 
the short version, and beql refers to the long version. 


6.2. Extended Branch as supports extended branch instmctions in addition to the instmctions which 

Instruction Mnemonics explicitly specify the instmction length. These instmction’s names are, in most 

cases, constmcted from the word versions by replacing the b with j. For 
example, compare beq with jeq. 

as’s mles for handling branch instmctions are as follows: 

a s automatically generates the corresponding short branch instmction if the 
operand of the extended branch instmction is a simple address in the text 
segment, and the offset to that address is sufficiently small. 
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□ as generates the corresponding branch instruction if the offset is too large 

for a short branch, but small enough for a branch. 

□ as implements an extended branch instruction when the operand either 
references an external address or is complex (see below) as follows: 

1. By a jmp or j sr (for jra or jbsr). 

2. If the target processor is the MC68010, by a conditional branch (with 
the sense of the condition inverted) around a jmp for the extended con¬ 
ditional branches. 

3. If the target processor is the MC68020, by using the corresponding long 
branch. 

The extended mnemonics should only be used in the text segment — if they are 
used in the data segment, the most general form of the branch is generated. 

In this context, a complex address is either an address which specifies other than 
normal mode addressing, or a relocatable expression containing more than one 
relocatable symbol. For instance, if a, b and c are symbols in the current seg¬ 
ment, the expression a+b-c is relocatable, but not simple. 

Consult Appendix B for a complete list of the instruction opcodes. 

6.3. Addressing Modes Table 6-1 below describes the addressing modes that as recognizes. Note that 

certain modes are not valid for the MC68010. The notations used in this table 
have these meanings: 



Meaning 


An address register. 


A data register. 


Either a data register or an address register. 

BlH 

A floating-point register. 

d 

A displacement, which is a constant expression in as. In 
MC68020 or MC68030 mode, a length specifier (: L, described 

below) may be appended to the displacement. Any forward or 
external references require the length specifier to be : 1. All 
other references permit either : 1 or : w or nulls. 

L 

The index register’s length. This may be either long (1) or word 
(w) or null. If the only value permitted by a particular addressing 
mode or category is 1 or w, then that letter appears in the table. 

s 

A scale factor that may be used to multiply the index register’s 
length. The scale factor may have a value of 1, 2, 4, or 8. 


The notation of two or three items separated by colons, such as r/: L: s, indi¬ 
cate items that may be optional. In that particular case, you may not specify : s 
unless you have specified :L, which you may not specify unless you have 
specified rf. The items in the list must appear in the order given in the tables 

that follow. 
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In the table where both d and d’ are S{^cified, d corresponds to an MC68020 or 
MC68030 outer displacement and d’ corresponds to an MC68020 or MC68030 
base displacement. 

XXX refers to a constant expression. 

Certain instructions, particularly move, accept a variety of special registers 
including: 


Name 

Register 

sp 

stack pointer, which is equivalent to a 7 

sr 

status register 

CC 

condition codes of the status register 

usp 

user stack pointer 

pc 

program counter 

sf c 

source function code register 

df c 

destination function code register 

fpcr 

floating-point control register 

fpsr 

floating-point status register 

fpiar 

floating-point instruction address register 


The memory-indirect and program-counter memory-indirect addressing modes 
listed in the following tables are useable only with the MC68020 and MC68030. 

In each of these addressing modes, up to four user-specified values are used to 
generate the final operand address: 

n base register 

□ base displacement 

□ index register 

□ outer dispacement 

All four user-specified values are optional. Both base and outer displacements 
may be null, word or long. When a displacement is null, or an element is 
suppressed, its value is taken as zero in the effective address calculation. 

In the case of memory-indirect addressing, an address register ( an) is used as a 
base register, and its value can be adjusted by an optional base displacement (d). 
An index register (ri) specifies an index operand (rz: L: s) and finally, an outer 
displacement ( d) can be added to the address operand, yielding the effective 
address. 

Program-counter memory-indirect mode is exactly the same. The only difference 
is that the program counter is used as the base register. 

Some examples of these addressing modes follow: 
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/ 

art@ id' iL, ri:L:s) @ {d 

. . . ' \ 

:L) 

an@ (c(: L) @ {d' : L, ri : 

L: s) 

art(a@ 


an@ {d:L )@ 


an@ {d' :L, ri: L: s) 0 


pcQQ 


pc& («i:L) 0 


/7C@ (J'' : L, ri : L : s ) @ (ii: L) 

pcQ {d:L) Q id' :L, ri: 

L : s) 

@ {d:L) @ 


@ (J' :L, ri:L:s) @ (ci: 

L) 

0 (£i:L) 0 id' :L, ri:L: 

s) 

& (d' : L, ri: L : s) @ 

V_ 

_ J 


In the table below, note that the notation ri/rj means ri and rj, while u rj means 
through rj. 


Table 6-1 


Addressing Modes 


Notation 


Example 


Register 

Register Deferred 


FPA register 
Floating-Point Register 
(MC68881 only) 


PC Displacement 

PC Word Index 
PC Long Index 
PC-Memory Indirect 
Pre-Indexed (68020) 
PC-Memory Indirect 
Post-Indexed (68020) 


Pre-Indexed (68020) 


Post-Indexed (68020) 


an,dn, sp,pc,cc,sr,usp 
an@ 

ri_rj or ri/r/ 



pc@ (d) 
pc@ (d, r/: w) 
pc@ (d, rill) 

pc@ (d'' :L,ri:L:s)@ (d:L) 
pc@ (d:L}@ (d' :L,ri:L:s) 


an@ ((i’ :L, ri:L: s) @ (d:L) 
an@ (£f:L) @ (d' :L, ri:L: s) 


a3,d2 
movw a3@,d2 

m a0-a4, a6@- 


move s f 
fmoves fpl,a3@(24) 


a3§+,d2 
movw a3@-,d2 


movw a3@(24),d2 
movw a3@(16, d2:w),d3 
movw a3@(16, d2:l),d3 


movw 14:w,d2 
movw 14:l,d2 


movw pc@(20),d3 
movw pc@(14, d2:w),d3 

movw pc@(14, d2:l),d3 

movl pc@ (2 :w, d4 jw: 4) @ (14 :1) , d' 

movl pc@(d:1)@(3:w,d2:1:4),d3 
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Table 6-1 Addressing Modes—Continued 


Mode 

Notation 

Example 

Normal 

identifier 

movw widget,d3 


^XXK 

movw #27+3,d3 


Normal mode assembles as PC-relative if the assembler can determine that this is 
appropriate, otherwise it assembles as either absolute short or absolute long, 
under control of the —d.2 command line option. 

The Motorola manuals present different mnemonics (and in fact different forms 
of the actual machine instmctions) for instmctions that use the literal effective 
address as data instead of using the contents of the effective address. For 
instance, they use the mnemonic adda for add address, as does not make 
these distinctions because it can determine the type of opcode required from the 
form of the operand. Thus an instmction of the form: 

avenue: .word 0 

addl #avenue,aO 

< _ / 


assembles to the add address instmction because as can determine that aO is an 
address register. 


r 




right__now: 

= 

40000 



addl 

#right__now, dO 





J 


assembles to an add immediate instmction because as can determine that 
right_now is a constant. 

Because of this determination of operand forms, some of the mnemonics listed in 
the Motorola manuals are missing from the set of mnemonics that as recognizes. 

Certain classes of instmctions accept only subsets of the addressing modes 
above. For example, the add instmction does not accept a PC-relative address as 
a destination, and register lists may be used only with the movem and fmovem 
instmctions. 

as tries to check all these restrictions and generates the illegal operand error 
code for instmctions that do not satisfy the address mode restrictions. 


6.4. Addressing Categories The processors group the effective address modes into categories derived from 

the manner in which they are used to address operands. Note the distinction 
between address modes and address categories. There are 14 addressing modes 
in the MC68010 and 18 in the MC68020 and MC68030, and they fall into one or 
more of four addressing categories. The addressing categories are defined here, 
followed by a table summarizing the grouping of the addressing modes into 
categories. Note that register lists can be used only in the movem and fmovem 
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instructions. 


Category 

Meaning 

Data 

means that the addressing mode is used to refer to data operands. 

Memory 

means that the addressing mode can refer to memory operands. 
Examples include all the a-register indirect address modes and 
all the absolute address modes. 

Alterable 

means that the addressing mode refers to operands which are 
writeable (alterable). This category takes in every addressing 
mode except the PC-relative addressing modes and the immedi¬ 
ate address mode. 

Control 

means that the addressing mode refers to memory operands with 
no explicit size specification. 


Some addressing categories can be intersected to make more restrictive ones. 
For example, the Motorola MC68010 manual mentions the Data Alterable 
Addressing Mode to mean that the particular instruction can only use those 
modes which provide data addressing and are alterable as well. 


Table 6-2 Addressing Categories 


Addressing 

Mode 

Assembler 

Syntax 

Data 

Memory 

Control 

Alterable 

MC68020 

and MC68030 
Only 

Register Direct 

an, dn, sp, pc^ 

cc^ sr, usp 

X 



X 


A-Register Indirect 

an@ 

X 

X 

X 

X 


A-Register Indirect 
with Displacement 

anQ (d:L) 

X 

X 

X 

X 

X 

A-Register Indirect 

with Word Index 

an@(d:L,rf:w:s) 

X 

X 

X 

X 

X 

A-Register Indirect 
with Long Index 

an@ (d: L, rt: 1: s) 

X 

X 

X 

X 

X 

A"Register Indirect 

with Post Increment 

anQ + 

X 

X 


X 


A-Register Indirect 

with Pre Decrement 

an@- 

X 

X 


X 


A-Register Indirect 
with Displacement 

anQ id) 

X 

X 

X 

X 


A-Register Indirect 

with Word Index 

an@ (d, ri:w) 

X 

X 

X 

X 



#sun 

microsystems 


Revision A of 27 March, 1990 











Chapter 6 — Instructions and Addressing Modes 


Table 6-2 Addressing Categories—Continued 


Addressing 

Mode 



Alterable 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 



and MC68030 

Only 


A"Register Indirect 
with Long Index 


Memory-Indirect 

Post-Indexed 


Memory-Indirect 

Pre-Indexed 


Absolute Short 


Absolute Long 


PC-relative 


PC-Indirect 


PC-relative with 
Word Index 


PC-Indirect with pc @ (: L, r /: w : s) 

Word Index 


PC-relative 
with Long Index 


an@ {d, ri:l) 


anQ {d:L) @ (d' :L, r/:L:s) 


an@ (d' :L, r/:L: s) @ (d:L) X 


1 


pc@ id) 


pc@ {d’.'L) 



pc@ ri: 1) 


PC-Indirect with pc@ ri: 1: s) 

Long Index 


PC-Memory Indirect pc@ (d: L) @ (d' : L, ri: L : s) 
Post-Indexed 


PC-Memory Indirect pc@ (d' : L, rz: L: s) @ (d: L) 
Pre-Indexed 


Immediate Data ^nnn 
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as Error Codes 


A.l. Usage Errors ^ 

® Cannot open output file 

The specified output file cannot be created. Check that the permissions 
allow opening this file. 


Cannot open source file 

The assembler cannot open the specified source file. Check the spelling, that 
the pathname supplied is correct, and that you have read permission for the 
file. 


No input file 

One or more input files must be specified — as cannot accept the output of 
a pipe as its input. 

Too many file names given 

The assembler cannot cope with more than one source file. Break the job 
into smaller stages. 


Unknown option ‘x’ ignored 

as does not recognize the option x. Valid options are listed in Section 1.1 of 
this manual. If you are using either cc or f 77 to assemble a . s file, you 
should specify any . as options that you want to use by using -Qoption 
as <option>. 


A.2. Assembler Error 

Messages 


If as detects any errors during the assembly process, it prints out a message of 
the form: 

- 

as: error (<line_no>) : <error_code> 

V___ I _^ 


Error messages are sent to standard error. Here is a list of as error codes, and 
their possible causes. 



Illegal .align 

The expression following a . align evaluates to some value other than 1, 2, 
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4 or 8. (If you are using .align 4, be sure to do the assembly with the ~ J 
flag set.) 

Invalid assignment 

An attempt was made to redefine a label with a direct assignment statement. 


Invalid Character 

An unexpected character was encountered in the program text. 


Invalid Constant 

An invalid digit was encountered in a number. For example, using an 8 or 9 
in an octal number. Also happens when an out-of-range constant operand is 
found in an instruction — for example: 


( 

addq 

#200,dO 

"1 


asll 

#12,dO 


\ 



J 


Invalid opcode 

The assembler did not recognize an instruction mnemonic. Probably a 
misspelling. 


Invalid operand 

The operand used is not consistent with the instruction used — for example: 


/• 


--- 


addqb #l,a5 


v_ 


y 


is an invalid combination of instruction and operand. Check the instmction 

set descriptions for valid combinations of instructions and operands. 


Invalid Operator 

Check the operand field for a bad operator. The operators that as recog¬ 
nizes are plus (+), minus (-), negate or one’s complement ("), multiply 
(*), and divide (/). 


Invalid register expression 

A register name was found where one should not appear — for example: 


r 


A 


addl #d0,_there 


\ _ 


J 


Invalid Register List 

The register list in a movem or fmovem instmction is malformed. Note 

that the list must contain more than one register name: to express a list 
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containing just a single register, you must write its name twice separated by 
a slash, e.g. f p 0 / f p 0. 


Invalid string 

An invalid string was encountered in an .asciior .asciz directive. 

□ Make sure the string is enclosed in double quotes. 

□ Remember that you must use the sequence \’* to represent a quote inside 
a string. 


Invalid symbol 

An operand that should be a symbol is not — for example: 


c — 


■'s 


.globl 3 


V._ 


J 


because the constant 3 is not a symbol. 

Invalid Term 

The expression evaluator could not find a valid term: a symbol, constant or 
< expression>, An invalid prefix to a number or a bad symbol name in an 
operand generates this message. 

Line too long 

A statement was found which has more than 4096 characters before the new- 
line character. 


Missing close-paren '/ 

An unmatched ‘(’ was found in an expression. 


Multiply defined symbol 

□ An identifier appears twice as a label. 

□ An attempt was made to redefine a label using a direct assignment state¬ 
ment. 

□ An attempt was made to use, as a label, an identifier which was previ¬ 
ously defined in a direct assignment statement. 


Multiply Defined Symbol (Phase Error) 

This rarely occurring message indicates an inconsistency in the assembler. 
Report it to Sun Microsystems Customer Support if it occurs. 


Non-relocatable expression 

If an expression contains a relocatable symbol (a label, for instance), the 
only operations that can be applied to it are the addition of absolute 
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expressions or the subtraction of another relocatable symbol (which pro¬ 
duces an absolute result). 


Odd address 

The previous instruction or pseudo-op required an odd number of bytes and 
this instruction requires word alignment. This error can only follow an 

.ascii, an .asciz,a .byte, or a . skip pseudo-operation. 

NOTE Use a . even directive to ensure that the location counter is forced to an even 
byte boundary. 

Ojfset too large 

The instruction is a relative addressing instruction and the displacement 

between this instruction and the label specified is too large for the address 

field of the instruction. 


Out of strings space 

No more room is left in the assembler’s internal string table. Divide the pro¬ 
gram into smaller portions; assemble portions of the program separately, 

then bind them together using the linker. 


Register out of range 

In the FPA’s dot product, matrix move and transpose instructions, if the 

register specified does not fall within the required range, this error is 

reported. Note that for most instructions where one operand is an effective 

address, the register range is 0 to 15. If all operands are FPA registers, the 

register range is 0 to 31. For constant RAM registers, the range is 0 to 511. 
This type of error will generally also cause the Invalid operand error to be 

reported. 

Stab storage exceeded 

No more room is left in the assembler’s symbol table for debugging infor¬ 
mation. Cut the program into smaller portions; assemble portions of the pro¬ 
gram separately, then bind them together using the linker. 


Symbol storage exceeded 

No more room is left in the assembler’s symbol table. Divide the program 

into smaller portions; assemble portions of the program separately, then bind 
them together using the linker. 


Symbol Too Long 

A local label reference longer than one digit was found. 


Undefined L-symbol ^ 

This is a warning message. A symbol beginning with the letter ‘L’ was used i y 

but not defined. It is treated as an external symbol. Compiler-generated 
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labels usually start with the letter ‘L’ and should be defined in this assembly. 
The absence of such a definition usually indicates a compiler code genera¬ 
tion error. This message is also generated by the use of symbols such as n$ 
if n$ has not been defined. 

Unqualified forward reference 

The displacement field in an MC68020 based/indexed address mode con¬ 
tains an unqualified forward reference. Note that the displacement in a 
based/indexed address mode for the MC68020 instruction set can contain a 
forward or external reference only if the length specifier is present. The 
length specifier should be : 1 (long). This type of error will generally also 
cause Multiply defined symbol (Phase error). 


Undefined Symbol 

A label reference to an undefined local label was found. 


Wrong number of operands 

Check Appendix B for the correct number of operands for the current 
instruction. 
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B 




List of as Opcodes 


This appendix is a list of the instruction mnemonics accepted by as, grouped 
alphabetically. The list is divided into two tables, the first covers the MC680x0 
processor’s instructions, the second covers the MC68881 and MC68882 
floating-point coprocessors’ instructions. For more information about floating¬ 
point programming, see the Floating-Point Programmer’s Guide. 

Each entry describes the following things: 

□ The mnemonics for the instruction, 
n The generic name of the instruction, 

□ The assembly language syntax and the variations on the instruction, 

n Whether the instmction is specific to the MC68020, or has extended capabil¬ 
ities on the MC68020 compared to the MC68010. 

The syntax for as machine instructions differs somewhat from the instruction 
layouts and categories shown in the Motorola processor manuals. For example, 
as provides a single set of mnemonics for add (add binary), adda (add 
address), and addi (add immediate), differentiated only by the length of the 
operands. In general, as selects the appropriate instruction from the form of the 
operands. 

Here is a brief explanation of the notations used below. 

□ An instruction of the form addX" in the assembly language syntax column 
means that the instruction is coded as addb, addw, addl, etc. 

□ An operand field of a« means any A-register. 

□ An operand field of dn means any D-register. 

□ An operand field of rn means any A- or D-register. 

□ An operand field of f n means any floating-point register. 

□ An operand field of c« means any control register. 

□ An operand field of ea means an effective address designated by one of the 
permissible addressing modes. Consult the relevant Motorola processor 
manual for details of the allowed addressing modes for each instruction. 
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An operand field of reglist means a “register list” specifying a list of regis¬ 
ters to be moved to or from memory. A register list is denoted by a slash- 

separated list of registers or ranges of registers, A range of registers is 
specified by the starting and ending register of that range, separated by a 

hyphen. 

For example, a register range including registers DO, Dl, and A4 could 

be specified as d0-dl/a4. 

□ An operand field of vector means an exception vector location. 

□ An operand field of Mata means an immediate operand. 

□ Other special registers such as cc (condition code register) and sr 
(status register) are specifically indicated where appropriate. 

The MC68020 and MC68030 provide a set of bit-field manipulating instruc¬ 
tions that don’t exist on the MC68010, Their notation includes a bit field 

specifier of the form {offsetiwidth}, where the offset denotes the beginning 
of the bit field in the word and the width is the number of bits in the field. 

Offset values are counted from the high-order bit, as 0, to the low-order bit, 
as 31. 

NOTE This ordering is the reverse of the convention used in the bchg, bclr, bset, 

andhtzt instructions. 

Offset and width may be either constants or data registers. For example: 

□ bfins dO,a5@(4) { #0 : #9} 

□ bfexta a5@(4) {dO :#8},d7 

In the table that follows, MC68020 entries in the "Processor" column indicate 

instructions found in MC68020 or later processors. 


Table B-1 List ofMC680x0 Instruction Codes 


















Table B -1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 

Operation Name 


Syntax 

Processor 

andw 


andX" 

dn, ea 


andl 


andX 

tkdata, dn 


aslb 

arithmetic shift left 

aslX 

dX,dy 


aslw 


aslY 

#data, d}! 


asll 


aslX 

ea 


asrb 

arithmetic shift right 

asrX 

dr, dj 


asrw 


asrX 

%data, d> 


asrl 


asrX 

ea 


bcc 

branch conditionally 

beeX 

label 


bed 




MC68020/030 

bees 





behg 

test a bit and change 

bchg 

dn, ea 




bchg 

%data, ea 


bclr 

test a bit and clear 

bclr 

dn,ea 




bclr 

tkdata, ea 




bkpt 

%data 

MC68020/030 


test a bit and set 

bset 

dn, ea 


■H 


bset 

%data,ea 


bt St 

test a bit 

bt st 

dn, ea 




bt St 

#data, ea 



test a bit field and change 

bf chg 

ea {ojfset i width } 



test a bit field and clear 

bf clr 

ea {ojfset : width } 

MC68020/030 

bfexts 

extract a bit field signed 

b f ext s ea[ offset : width } ,dn 

MC68020/030 


extract a bit field unsigned 

bf ext u ea { offset ; width } ,dn 

MC68020/030 

bfffo 

find first one in bit field 

bfffo 

ea { offset : width } ,dn 

MC68020/030 

bf ins 

insert a bit field 

bf ins 

dn, ea{ offset : width } 

MC68020/030 

bf set 

test a bit field and set 

bf set 

ea { offset: width } 

MC68020/030 

bftst 

test a bit field 

bftst 

ea {offset : width} 

MC68020/030 

bes 

branch carry set 

besX 

ea 


besl 




MC68020/030 

bess 





beq 

branch on equal 

beqX 

ea 


beql 




MC68020/030 

beqs 





bge 

branch greater or equal 

bgeX 

ea 


bgel 




MC68020/030 
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Mnemonic 


bges 


Operation Name 


branch greater or equal 


branch greater than 


Syntax 


Processor 




bsr 

subroutine branch 

bsrl 


bsrs 


bvc 

branch overflow clear 

bvcl 


bvcs 




cas2b 

cas21 


call module 


compare & swap with operand 


MC68020/030 



rn2) MC68020/030 
MC68020/030 
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Table B -1 List ofMC680x0 Instruction Codes — Continued 


imHii 

Operation Name 


Syntax 

Processor 

cas2w 

compare & swap with operand 


MC68020/030 

cash 

compare & swap with operand 

casX 

dc, dw, ea 

MC68020/030 

casl 




MC68020/030 

casw 




MC68020/030 

chkb 

check register against bounds 

chkX 

ea, dn 

MC68020/030 

chkw 




MC68020/030 

chkl 




MC68020/030 

chk2b 

check register against bounds 

chk2X 

ea, rn 

MC68020/030 

chk21 




MC68020/030 

chk2w 




MC68020/030 


clear an operand 

clrX 

ea 







clrl 






compare register against bounds 

cmp2X 

ea, rn 

MC68020/030 





MC68020/030 





MC68020/030 


compare memory 

cmpmX 

a}'@ + , 3X0 + 


cmpb 

arithmetic compare 

o 

3 

ea, dn 


cmpw 


CTOpX 

#data,ea 


cmpl 





dbcc 

decrement & branch on carry clear 

dbcc 

dn, label 


dbcs 

" on carry set 

dbcs 

dn, label 


dbeq 

" on equal 

dbeq 

dn, label 


dbf 

" on false 

dbf 

dn, label 


dbge 

" on greater than or equal 

dbge 

dn, label 


dbgt 

" on greater than 

dbgt 

dn, label 


dbhi 

" on high 

dbhi 

dn, label 


dble 

" on less than or equal 

dble 

dn, label 


dbls 

" on low or same 

dbls 

dn, label 


dblt 

" on less than 

dblt 

dn, label 


dbmi 

" on minus 

dbmi 

dn, label 


dbne 

" on not equal 

dbne 

dn, label 


dbpl 

" on plus 

dbpl 

dn, label 


dbra 

" always (same as dbf) 

dbra 

dn, label 


dbt 

" on True 

dbt 

dn, label 


dbvc 

" on overflow clear 

dbvc 

dn, label 


dbvs 

" on overflow set 

dbvs 

dn, label 


divs 

signed divide 

divs 

ea, dn 


divsl 


divsX 

ea, dn 

MC68020/030 

divsll 


divsX 

ea, dq 

MC68020/030 
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List of MC680x0 Instruction Codes — Continued 


Mnemonic 


extbl 

extw 

extl 


Operation Name 


unsigned divide 



exchange registers 


d 




jump carry clear 
jump on carry 
jump on equal 
jump greater or equal 


jump higher 

jump less than or equal 

jump lower or same 

jump less than 

jump minus 

jump not equal 

jump positive 

jump always 

jump to subroutine 

jump no overflow 

jump on overflow 


load effective address 


link and allocate 


logical shift left 
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divsX ea,dr:6q 


divu ea, dn 
divuX ea,dn 



divull 

. ea.drtdq 

eorTf 

dn, ea 

eorX 

%data, ea 

eorb 

%data, cc 

eorw 

%data, sr 



extbl dn 
extX dn 


jmp ea 
jsr ea 


jgt ea 

jhi ea 
jle ea 





MC68020/030 

MC68020/030 

MC68020/030 

MC68020/030 



MC68020/030 


jit 

ea 

jmi 

ea 

jne 

ea 

jpl 

ea 

jra 

ea 

jbsr 

ea 

jvc 

ea 




link 

an, %disp 

linkl 

an, %disp 

IslX 

dx, dy 

IslX 

%data, dy 

IslX 

ea 

IsrX 

dx, dy 

IsrX 

%data, dy 






Revision A of 27 March, 1990 








































Syntax 

Processor 

Isrl 

logical shift right 

IsrX 

ea 


movb 

move data 

mov2f 

ea, ea 


movl 





movw 


movX 

%data, dn 


movw 

move from condition code register 

movw 

cc, ea 


movw 

move from status register 

movw 

ST, ea 


move 

move to/from control register 

move 

rn, cr 




move 

cr, rn 


moveml 

move multiple registers 

moveml ^mask, ea 


movemw 


movemX’ ea, %mask 




movemX” ea,reglist 




moveml reglist, ea 


movepl 

move peripheral 

movepX dn, an% {d) 


movepw 


movepX an& (d) , d« 


moveq 

move quick 

moveq 

idata, dn 


movsb 

move to/from address space 

movsX 

rn, ea 


movsw 


movsX 

ea, rn 


movsl 





mu Is 

signed multiply 

mu Is 

ea, dn 


mulslw 


mulsX 

ea, dl 

MC68020/030 

mulsll 


mulsZ 

ea, dh: dl 

MC68020/030 

mulu 

unsigned multiply 

mulu 

ea, dn 


mulul 


muluX 

ea, di 

MC68020/030 



muluX 

ea, dh: dl 

MC68020/030 

nbed 

negate decimal with extend 

nbed 

ea 


negb 

negate binary 


ea 


negw 


■i 



negl 


■ 



negxb 

negate binary with extend 

negxX 

ea 


negxw 





negxl 





nop 

no operation 

nop 


notb 

logical complement 

notX 

ea 


notw 





notl 





orb 

inclusive or 

orX ea, dot 


orw 


orX dn,ea 


orl 


or %data,ea 




orb §daia,cc 



♦ sun 
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Table B-1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 

Operation Name 

Syntax 

Processor 

spl 

set plus 

spl ea 


smi 

set minus 

smi ea 


sge 

set greater or equal 

sge ea 


sit 

set less than 

sit ea 


sgt 

set greater than 

sgt ea 


sle 

set less than or equal 

sle ea 


subqb 

subqw 

subql 

subtract quick 

subtract quick 

subqX ^data,ea 


subxb 

subxw 

subxl 

subtract extended 

subxX dy,dx 
subxX ay@--,ajc@“ 


swap 

swap register halves 

swap dn 


tas 

test operand then set 

tas ea 


trap 

trap 

trap ^vector 


trapcc 

trap on carry clear 

trapeeX 

MC68020/030 

trapccl 

trapccw 


trapeeX ^data 

MC68020/030 

MC68020/030 

trapes 

trap on carry set 

trapesx 

MC68020/030 

trapcsl 

trapesw 


trapesX §data 

MC68020/030 

MC68020/030 

trapeq 

trap on equal 

trapeqX 

MC68020/030 

trapeql 

trapeqw 


trapeqX %data 

MC68020/030 

MC68020/030 

trapf 

trap on never true 

trapfX 

MC68020/030 

trapf1 

trapfw 


trapfX §data 

MC68020/030 

MC68020/030 

trapge 

trap on greater or equal 

trapgeX 

MC68020/030 

trapgel 

trapgew 


trapgeX %data 

MC68020/030 

MC68020/030 

trapgt 

trap on greater 

trapgtX 

MC68020/030 

trapgtl 

trapgt 


trapgtX ^data 

MC68020/030 


The following table describes the MC68881 instruction mnemonics supported by 
as. 

Each mnemonic indicates the data type that it operates on by the last character of 
the mnemonic: 

□ b indicates a byte format instruction 
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□ w indicates a word format instruction 

□ 1 indicates a long format instruction 

□ s indicates a single-precision format instruction 

□ d indicates a double-precision format instruction 

□ X indicates an extended-precision format instruction 

□ p indicates a packed format instruction 

□ y indicates that any of 1, s, p, w, d, or b, is acceptable. 


Table B-2 MC68881 Instructions supported by as 


Mnemonic 

Operation Name 

Syntax 

f absx 

absolute value 

fabsx ea, fn 

f absl 


fabsx fm, fn 

fabss 


fabsy ea,fn 

f absp 



fabsw 



f absd 



fabsb 



facosx 

arc cosine 

facosx ea,fn 

facosl 


facosx fm,fn 

facoss 


facosy ea,fn 

facosp 



facosw 



facosd 



facosb 



faddx 

add 

faddx ea^ fn 

faddl 


faddx fm, fn 

fadds 


faddy ea,fn 

f addp 



faddw 



f addd 



faddb 



fasinx 

arc sin 

fasinx ea,fn 

fasinl 


fasinx fm,fn 

fasins 


fasiny ea, fn 

fasinp 



fasinw 



fasind 



fasinb 



fatanx 

arc tangent 

fatanx ea,fn 

fatanl 


fatanx fm, fn 

fatans 


fatany ea, fn 

fatanp 



fatanw 
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Table B-2 

MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

fatand 

arc tangent 


fatanb 



fatanhx 

hyperbolic arc tangent 

fatanhx ea, tn 

fatanhl 


fatanhx fm,fn 

fatanhs 


fatanhy ea, fn 

fatanhp 

hyperbolic arc tangent (could.} 


fatanhw 



fatanhd 



fatanhb 



fbcc 

branch conditionally 

fbcc label 

fbeq 

(equal) 


fbeql 



fbf 

(false) 


fbfl 



fbgt 

(greater than) 


fbgtl 



fble 

(less than or equal) 


fblel 



fblt 

(less than) 


fbltl 



fbge 

(greater than or equal) 


fbgel 



fbgl 

(greater than or less) 


fbgll 



fbgle 

(greater less or equal) 


fbglel 



fbgt 

(greater than) 


fbne 

(not equal) 


fbnel 



fbneq 

(not (equal)) 


fbneql 



fbnge 

(not greater than or equal) 


fbngel 



fbngl 

(not greater than or less) 


fbngll 



fbngle 

(not greater than, less or equal) 


fbnglel 



fbngt 

(not greater than) 


fbngtl 



fbnle 

(not less than or equal) 


fbnlel 



fbnlt 

(not less than) 


fbnltl 



fbt 

(true) 
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Table B-2 



Mnemonic 


Syntax 

fbtl 

(true) 


fbor 

fborl 

(ordered) 


fbocc 

branch ordered conditionally 

fbocc label 

fboge 

fbogel 

(ordered greater or equal) 


fbogl 

fbogll 

(ordered greater or less) 


fbogt 

fbogtl 

(ordered greater than) 


fbole 

fbolel 

(ordered less or equal) 


fbolt 

fboltl 

(ordered less than) 


fbcc 

branch signalling conditionally 

fbscc label 

fbseq 

fbseql 

(signalling equal) 


fbsf 

fbsfl 

(signalling false) 


fbsne 

fbsnel 

(signalling not equal) 


fbst 

fbstl 

(signalling true) 


fbucc 

branch unordered conditionally 

fbucc label 

fbueq 

fbueql 

(unordered equal) 


fbuge 

fbugel 

(unordered greater or equal) 


fbugt 

fbugtl 

(unordered greater than) 


fbule 

fbulel 

(unordered less or equal) 


fbult 

fbultl 

(unordered less than) 


fbun 

fbunl 

(unordered) 


f cmpx 

compare 

f cmpx ea, fn 

f cmpl 


fcmpx fm, fn 

f cmps 

f cmpp 

f cmpw 

f cmpd 
f cmpb 


fcmpy ea,fn 


Asun 
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Table B-2 

MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

fcosx 

cosine 

fcosx ea, fn 

fcosl 


fcosx fm,fn 

f coss 

fcosp 

f cosw 

f cosd 

f cosb 


fcosy ea, fn 

fcoshx 

hyperbolic cosine 

fcoshx ea,fn 

fcoshl 


fcoshx fm, fn 

fcoshs 

fcoshp 


fcoshy ea,fn 

fcoshw 

fcoshd 

fcoshb 

hyperbolic cosine (contd.) 


fdbcc 

decrement & branch on condition 

fdbcc dn, label 

fdbeq 

(equal) 


fdbne 

(not equal) 


f dbgt 

(greater than) 


fdbngt 

(not greater than) 


fdbge 

(greater or equal) 


fdbnge 

(not greater or equal) 


fdblt 

(less than) 


fdbnlt 

(not less than) 


fdble 

(less or equal) 


fdbnle 

(not less or equal) 


fdbgl 

(greater or less) 


fdbngl 

(not greater or less) 


fdbgle 

(greater, less or equal) 


fdbngle 

(not greater, less or equal) 


fdbogt 

(ordered greater than) 


fdbule 

(unordered less or equal) 


fdboge 

(unordered greater or equal) 


fdbult 

(unordered less than) 


fdbolt 

(ordered less than) 


fdbuge 

(unordered greater or equal) 


fdbole 

(ordered less or equal) 


fdbugt 

(unordered greater than) 


fdbogl 

(ordered greater or less) 


fdbueq 

(unordered equal) 


f dbor 

(ordered) 


fdbun 

(unordered) 


fdbf 

(false) 


f dbt 

(true) 


fdbsf 

(signalling false) 
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Table B-2 


SI 


'ed by as— 


tit 



Mnemonic 


Operation Name 


Syntax 



fdivx 


f divp 


fdivb 



(signalling not equal) 


fdivx ea, fn 
fdivx fm,fn 
fdiv}? ea,fn 


fetoxx 
fetoxl 
fetoxs 
fetoxp 
fetoxw 
fetoxd 
fetoxb 


fetoxmlx 

fetoxmll 
fetoxmls 
fetoxmlp 

fetoxmlw 
fetoxmld 
fetoxmlb 


fetoxx ea, fn 
fetoxx fm, fn 

fetox}? ea,fn 


fetoxmlx ea, fn 

fetoxmlx fm, fn 
fetoxmly ea, fn 


fgetexpx 
fgetexpl 
fgetexps 
fgetexpp 
fgetexpw 
fgetexpd 
fgetexpb 


fgetmanx 
fgetmanl 
fgetmans 
fgetmanp 
fgetmanw 
fgetmand 
fgetmanb 


f intx 


f intp 
f intw 


get exponent 



get mantissa 


integer part 


fgetexpx ea, fn 
fgetexpx fm, fn 
Tgetexpj ea,fn 


fgetmanx ea, fn 
fgetmanx fm, fn 
fgetmanj ea, fn 


fintx ea, fn 
fintx fm, fn 
fint3? ea, fn 
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Table B-2 



Mnemonic 

Operation Name 

Syntax 

fintd 

integer part 


f intb 



fintrx 

integer part, round toward 0 

fintrx ea,fn 

fintrzl 


fintrx fm, fn 

fintrzs 


fintr}! ea, fn 

fintrzp 



fintrzw 



fintrzd 



fintrzb 



fjcc 

jump on condition 

fjcc label 

f jeq 

(equal) 


f jne 

(not equal) 


f jneq 

(not equal or equal) 


f jgt 

(greater than) 


f jngt 

(not greater than) 


f jge 

(greater or equal) 


f jnge 

(not greater or equal) 


f j It 

(less than) 


f jnlt 

(not less than) 


f j le 

(less or equal) 


f jnle 

(not less or equal) 


f jgl 

(greater or less) 


f jngl 

(not greater or less) 


f jgle 

(greater, less or equal) 


fjngle 

(not greater, less or equal) 


f jogt 

(ordered greater than) 


f jule 

(unordered less or equal) 


f joge 

(ordered greater or equal) 


f jult 

(unordered less than) 


f jolt 

(ordered less than) 


f juge 

(unordered greater or equal) 


f jole 

(ordered less or equal) 


f jugt 

(unordered greater than) 


f jogl 

(ordered greater or less) 


f jueq 

(unordered equal) 


f jor 

(ordered) 


f jun 

(unordered) 


f jf 

(false) 


f jt 

(true) 


f j sf 

(signalling false) 


f j st 

(signalling true) 


f jseq 

(signalling equal) 


f j sne 

(signalling not equal) 


floglOx 

login 

floglOx ea,fn 
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Table B-2 


“ Continued 

Mnemonic 

Operation Name 

Syntax 

floglOl 

logjo 

floglOx fm, fn 

floglOs 


floglOy fn 

floglOp 



floglOw 



floglOd 



floglOb 



flog2x 

log2 

flog2x ea,fn 

flog21 


flog2x fm,fn 

flog2s 


flog2y ea, fn 

flog2p 



flog2w 

log 2 ( contd.) 


flog2d 



flog2b 



flognx 

logg 

flognx ea, fn 



flognx fm,fn 



flogny ea, fn 

flognp 



flognw 



flognd 



flognb 



flognplx 

logg(x+l) 

flognplx ea, fn 

flognpll 


flognplx fm,fn 

flognpls 


flognply ea, fn 

flognplp 



flognplw 



flognpld 



flognplb 



fmodx 

modulo 

fmodx ea, fn 

fmodl 


fmodx fm,fn 

fmods 


fmody ea,fn 

fmodp 



fmodw 



fmodd 



fmodb 



fmovex 

move fp register 

fmovex ea,fn 

fmovel 


fmovex fm,ea 

fmoves 


fmovey ea, fn 

fmovep 



fmovew 



fmoved 



fmoveb 



fmovecrx 

move constant ROM 

fmovecrx %ccc, fn 
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Table B-2 

MC68881 Instructions supported by as — Continued 


Mnemonic 


Syntax 

fmovemx 

move multiple data registers 

fmovemy ea, list 

fmoveml 


fmovemx list, ea 

fmovem 


fmoveml ea, dn 



fmovem dn, ea 

fmulx 

multiply 

fmulx ea, fn 

fmull 


fmulx fm, fn 

fmuls 


fmuly ea, fn 

fmulp 



fmulw 

multiply (contd.) 


fmuld 



fmulb 



fnegx 

negate 

fnegx ea, fn 

fnegl 


fnegx fm,fn 

fnegs 


fnegy ea, fn 

fnegp 



fnegw 



fnegd 



fnegb 



fnop 

no operation 

fnop 

f remx 

IEEE remainder 

fremx ea, fn 

f reml 


fremx fm,fn 

f rems 


f remy ea, fn 

f remp 



f remw 



f remd 



fremb 



frestore 

restore internal state 

frestore ea 

f save 

save internal state 

fsave ea 

fsealex 

scale exponent 

fscalex ea, fn 

fscalel 


fscalex fm,fn 

fscales 


f scaley ea, fn 

fscalep 



fscalew 



fscaled 



fscaleb 



f see 

set according to condition 

fscc ea 

f seq 

(equal) 


f sne 

(not equal) 


f sneq 

(not equal or equal) 


f sgt 

(greater than) 


f sngt 

(not greater than) 


f sge 

(greater or equal) 


f snge 

(not greater or equal) 
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Operation Name 


(less than) 


(less or equal) 

(not less or equal) 


Syntax 



f sngl 

(not greater or less) 

f sgle 

(greater, less or equal) 

fsngle 

(greater, less or equal) 

f sogt 

(not greater, less or equal) 

f sule 

(unordered less or equal) 

f soge 

(ordered greater or equal) 

f suit 

(unordered less than) 

f solt 

(ordered less than) 

f suge 

(unordered greater or equal) 

f sole 

(ordered less or equal) 


f sogl 

(ordered greater or less) 

f sueq 

(unordered equal) 

f sor 

(ordered) 

f sun 

(unordered) 

f sf 

(false) 

f St 

(true) 

f ssf 

(signalling false) 




.divx 

single-precision divide 

fsgldivx ea,f.n 

.divs 


fsgldivx fm,fn 

.divl 


fsgldivy ea,fn 

.divp 



.divw 



.divb 




fsglmulx 

fsglmuls 

fsglmull 

fsglmulp 

fsglmulw 
fsglmulb 

single-precision multiply 

f sglmulx ea, fn 
fsglmulx fm,fn 
fsglmuly ea,fn 

f sinx 

sin 

fsinx ea, fn 

f sinl 


fsinx fm,fn 

f sins 


fsiny ea,fn 

f sinp 

f sinw 

f sind 




♦ s 
















Table B-2 MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

IBBSSHHHIi 

sin 


fsincosx 

simultaneous sine and cosine 

fsincosx ea,fc:fs 

fsincosl 


fsincosx 

fsincoss 


fsincosy ea,fcifs 

fsincosp 



fsincosw 

simultaneous sine and cosine (contd.) 


fsincosd 



fsincosb 



fsinhx 

hyperbolic sine 

fsinhx ea, fn 

fsinhs 


fsinhx fm, fn 

fsinhp 


f sinhy ea, fn 

fsinhw 



fsinhd 



fsinhb 



fsqrtx 

square root 

fsqrtx ea,fn 

fsqrtl 


fsqrtx fm, fn 

fsqrts 


fsqrty ea, fn 

fsqrtp 



fsqrtw 



fsqrtd 



fsqrtb 



f subx 

subtract 

fsubx ea,fn 

fsubl 


fsubx fm,fn 

f subs 


fsuby ea,fn 

f subp 



f subw 



f subd 



f subb 



ftanx 

tangent 

ftanx ea, fn 

ftanl 


ftanx fm,fn 

ftans 


ft any ea,fn 

ftanp 



ftanw 



ftand 



ftanb 



ftanhx 

hyperbolic tangent 

ftanhx ea,fn 

ftanhl 


ftanhx fm,fn 

ftanhs 


ftanhy ea, fn 

ftanhp 



ftanhw 



ftanhd 



ftanhb 
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Table B-2 MC68881 Instructions supported by as— Continued 


Mnemonic 

ftentoxx 

ftentoxl 

ftentoxs 

ftentoxp 

ftentoxw 

ftentoxd 

ftentoxb 


ftrapcc 

ftrapeq 

ftrapeqw 

ftrapeql 

ftrapne 

ftrapnew 

ftrapnel 

ftrapgt 

ftrapgtw 

ftrapgtl 

ftrapngt 

ftrapngtw 

ftrapngt1 

ftrapge 

ftrapgew 

ftrapgel 

ftrapnge 

ftrapngew 

ftrapngel 

ftraplt 

ftrapltw 

ftrapltl 

ftrapnlt 

ftrapnltw 

ftrapnltl 

ftraple 

ftraplew 

ftraplel 

ftrapnle 

ftrapnlew 

ftrapnlel 

ftrapgl 

ftrapglw 

ftrapgll 

ftrapngl 

ftrapnglw 

ftrapngll 

ftrapgle 


Operation Name 


10^ (contd.) 


trap conditionally 
(equal) 


(not equal) 


(greater than) 


(not greater than) 


(greater or equal) 


(not greater or equal) 


(less than) 


(not less than) 


(less than or equal) 


(not less than or equal) 


(greater than or less) 


(not greater than or less) 


Syntax 

ftentoxx ea, fn 
ftentoxx fm, fn 
ftentoxy ea,fn 


ftrapcc 
ftrapcc %data 


greater, less or equal) 
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Table B-2 MC68881 Instructions supported by as— Continued 


Operation Name 


Syntax 


ftrapglew 

ftrapglel 


ftrapngle 
ftrapnglew 
ftrapnglel 
ftrapogt 
ftrapogtw 
ftrapogtl 
ftrapule 
ftrapulew 
ftrapulel 
ftrapoge 
ftrapogew 
ftrapogel 
ftrapult 
ftrapultw 
ftrapult1 
ftrapolt 
ftrapoltw 
ftrapoltl 
ftrapuge 
ftrapugew 
ftrapugel 
ftrapole 
ftrapolew 
ftrapolel 
ftrapugt 
ftrapugtw 
ftrapugtl 
ftrapogl 
ftrapoglw 
ftrapogll 
ftrapueq 
ftrapueqw 
ftrapueql 
ftrapor 
fftraporw 
ftraporl 
trapun 
ftrapunw 
ftrapunl 
ftrapf 
ftrapfw 
ftrapf1 
ftrapt 


(not greater, less or equal) 


(ordered greater than) 


(unordered less or equal) 


(ordered greater or equal) 


(unordered less than) 


(ordered less than) 


(unordered greater or equal) 


(ordered less or equal) 


(unordered greater than) 


(ordered greater or less) 


(unordered equal) 


(ordered) 


(unordered) 
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Operation Name 

Syntax 

ftraptw 
ftrapt1 
ftrapsf 
ftraptw 
ftrapsf1 

(signalling false) 


ftrapst 

(signalling true) 


ftrapsfw 

ftrapstl 
ftrapseq 
ftrapseqw 
ft rapseql 

(signalling equal) 


ftrapsne 
ftrapsnew 
ft rapsnel 

(signalling not equal) 


ftstx 

test operand 

ftstx ea 

ft stl 


ftstx fm 

ft st s 


ft sty ea 

ft stp 



ftstw 



ft std 



ft stb 



ftwotoxx 

2^ 

ftwotoxx ea, fn 

ftwotoxl 


ftwotoxx fm,fn 


ftwotoxs 

ftwotoxp 

ftwotoxw 

ftwotoxd 

ftwotoxb 


ftwotoxy ea,fn 
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FPA Assembler Syntax 


This appendix describes the Sun Floating-Point Accelerator (FPA) support exten¬ 
sions to as included in Sun software release 3,1 and later. 

The extensions to as are described in general, with discussions of two-, three-, 
and four-operand instruction examples. Some instructions covered separately 
don’t follow the formats described at the beginning of the appendix. The appen¬ 
dix includes restrictions and potential errors, followed by a summary of sup¬ 
ported floating-point instmctions. 


C.l. Instruction Syntax The general format for floating-p>oint instructions is 



where 


f p indicates an FPA instruction. 
op is the opcode name. 

t is the operand type, either single (s) or double (d). 

The @A part of the instruction is optional. When present, A sp)ecifies the address 
register which contains the base address for the FPA and can be in the range 0..7. 
If this form is used, a previous instruction must load the FPA address 
(OxeOOOOOOO) into the specified address register. 

If @A is not present, then absolute long addressing is used to refer to the FPA. 
This form is more efficient for short routines. 

Depending on the instruction, there may be from zero to four op)erands specified. 
The operands can be any of the following forms: 

□ Any MC68020 effective address, with the exception that absolute short 
addresses are not allowed for double-precision values. 


o If either of the data register or the address register is used to hold a double¬ 
precision value, then the value will be in a register pair and both registers, 
separated by a colon, must be specified in the instruction. For example: 
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C.2. Register Syntax 


C.3. Operand Types 


C.4. Two-Operand 
Instructions 


The only exception to this rule is the fpltod instruction (convert integer to 
double-precision value). 

□ In some instructions (command register type) it is possible to specify that the 
register be in constant RAM. The syntax used for this case is %«, where n is 
a register number in the range 0 to 511. 

The 32 floating-point data registers are designated fpaO ^ fpal, . . ., 
fpa31. The supported control registers are: 


Hardware 

Software 

MODE3___0 

fpamode 

WSTATUS 

fpastatus 


as supports three floating-point operand types: 

□ s for single-precision floating-point o^rands. 

□ d for double-precision floating-point operands. 

□ 1 for 32-bit integer operands, used for integer to floating-point conversions. 


Opcodes such as add, subtract, multiply, divide, negate, absolute value, square 
root, conversion from integer to floating-point, conversion from single to double 
(and vice versa) are all represented as: 


f 


f-popt X, fpan 


V 

J 


where t= s or d, and X is any valid MC68020 effective address for an operand or 
is an FPA data register. 

If X is an FPA register which is in the constant RAM, then it can be in the range 
0 to 511. If it is not in constant RAM, then it is one of the 32 FPA data registers. 
If X is art FPA register, then f paw is one of the 32 floating-point data registers. 
If X is an effective address, then f pan is one of the FPA registers in the range 0 
to 15. The following are examples of such instructions: 


f - 




Instruction 

Computes 

fpnegs 

<ejfective address> , fpal 


fpsqrd 

Keffective address>, f pa2 


fpsubs 

fpal^ fpa2 

fpa2 fpa2 - fpal 

fprsubs 

fpal^ fpa2 

f^a2 <— fpal - fl)a2 

fpdivs 

dO, fpa2 

lpa2 <— ipa2 / dO 

fprdivs 

do, fpa2 

fpa2 <— do / fpa2 

1 


J 


In the above examples fpr subs and fprdivs are the reverse subtract and 
reverse divide operators, respectively. 


#sun 

microsystems 


Revision A of 27 March, 1990 







Appendix C — FPA Assembler Syntax 67 



The opcodes for sine, cosine, atan, e'x, e'^x-l, ln(x), 
ln(l+x), sqrt(x),and s in co s (x) are all supported as command- 
register type instructions; 

- 

fpopt fpaXf fpan 


where t= s or d. 

f pa;c is either a floating-point register or a register in the constant RAM (which 
is specified as ^number). For the sincos instruction, the destination operand 
is actually a register pair: 


r 

A 

fpsincosf fpax, fpac:fpaj 


V 

7 


C.5. Three-Operand 

Instructions 


where f pac is the cosine’s destination and f paj is the sine’s destination. 


The opcodes -b, -, *, / are supported in extended and command-register forms as 


f 


A 

fpop3t 

Xf fpam, fpan 


1_ 


J 


where t= s or d and X is an <ejfective address> for an extended instruction or 
a floating-point register for a command-register type of instmction. 

; In the command-register form, X and f pam can indicate a register number in 

the constant RAM. That is, they can either be in the range 0 to 511 or in the 
range 0 to 31. In xhs extended instruction form, f pam and fpan must be in 
the range 0 to 15. In the above format the positions ofX and fpam can be 
exchanged for the commutative operators add and multiply (the result of the 
operation remains the same). 


For example. 


f - 

fpa2 <— <ejfective address> + fpal 


can be represented by either of the following forms: 


r 

fpaddSs <effective address> , fpal, fpa2 
fpaddSs fpal, <effective address> , fpa2 

V 


The same rule applies to subtract and divide operations. However, they are not 
commutative, so different answers result from each order. For example. 


f 

fpa2 <— fpal - <ejfective address> 

V_. _ 


must be coded as: 

fpsubSs <effective address>f fpal, fpa2 


V _ 

J 
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whereas 


f 


fpa2 <— <ejfective address> - fpal 


L 

_ 2 


must be coded as: 


r 

fpsubSs fpal, Kejfective address>f fpa2 

^ _____ 

A 

_> 

Following the same format, 

r 


fpa3 «“ fpa2 - fpal 


V.___ 

y 


must be coded as: 


r 


A 


fpsubSs fpal, fpa2, fpa3 


A_ 


J 


C,6. Four-Operand In the extended and command-register formats there are pivot instmctions of the 

Instructions form: 


f - 

1 

fpopt Xf fpax, fpay, fpan 


V___ 

J 


where f pa« is the destination floating-point data register, t= s or d, and X is 

an effective address or a floating-|X)int register. 

In the extended form, the positions of X and f paj can be exchanged for both 

single- and double-precision ty^^s of instructions. In single-precision extended 
form, it is possible for two of the four operands to be effective addresses. This is, 
in general, either the first and third or the second and third operands. 

In the command register form, f pa;r and f pay can be replaced by %x and %y 
indicating register numbers x and y in the constant RAM. 

For four-operand instmctions, f pax, f pay and f pan can each be in the range 
0 to 15 when X is an effective address. If X is an FPA register, then X and fpaw 

must be in the range 0 to 3 1 and f pax and f pay can either be in the range 0 to 

511 (designating a location in constant RAM) or else in the range 0 to 31. 

These pivot instmctions are rather complicated and will be dealt with com¬ 
pletely. The following shows the forms of each operation, the assembly code 
equivalent to each form, a generalization of the assembly instmction and a 

sequence of operations equivalent to the pivot instmction. 
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f 

Instruction 

Meaning 


fpma { s,d } 

<ejfective address> f reg2, reg3, regl 

regl <— reg3 + (reg2 * operand) 


fpma {s, d} 

reg2, reg3, <effective address> , regl 

regl <— operand + (reg3 * reg2) 


fpma { s, d} 

reg4, reg2, reg3, regl 

regl <— reg3 + (reg2 * reg4) 


fpmas 

<eal>f reg2, <ea2> , regl 

regl <— operand2 + (reg2 * operand 1) 


V_ 



J 


The f pma instruction, where m stands for multiply, and a stands for add, can 
be generalized as 


f 


fpma/ X, fpax, fpay, fpan 



J 


where r is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. Also, for single precision either the first and third of^rands or 
the second and third operands can be effective addresses. Note that, for example, 


f 

fpmas dO, fpal, fpa2, fpa3 

-X 

V. 

J 



is equivalent to the following sequence of instructions 
- 

fpmul3s dO, fpal^ temp 

fpaddSs temp, fpa2, temp 

fpmoves temp, fpa3 

V_ ) 


where temp is a temporary register. 

r 

Instruction 


Meaning 


fpms{s,d} 
fpms{s,d} 
fpms{s,d} 
fpmss 

V 

<effective address>, reg2, reg3, 
reg2, reg3, <ejfective address>, 
reg4, reg2, reg3, regl 
<eal>f reg2, <ea2>, regl 

regl 

regl 

regl <— reg3 - (reg2 * operand) 
regl <— operand - (reg3 * reg2) 
regl <— reg3 - (reg2 * reg4) 
regl <— operand2 - (reg2 * operand 1) 



The f pms instruction, where m stands for multiply, and s stands for subtract, 
can be generalized as 




> 

fpms/ 

X, fpax, fpay, fpan 




_/ 



where r is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. Also, in single-precision two-memoiy instructions, either the 
first and third operands or the second and third operands can be effective 
addresses. Note that, for example, 



- - 

A 

fpmss fpal, fpa2, dO, fpa3 


V 
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is equivalent to the following sequence of instructions 


r 




fpmulSs 

fpal. 

fpa2, temp 


fpsubSs 


dO, temp 


fpmoves 

^_ 

temp. 

fpa3 

j 


The f pmr instruction, where m stands for multiply, and r stands for reverse 
subtract, can be generalized as 












where r is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended tyfx; of instruction, the positions of X and fpay 
can be exchanged. 


f - 

Instruction 


A 

Meaning 

fpmr{s,d} 

<ejfective address>, reg2, reg3. 

regl 

regl <- (-reg3) + (reg2 * operand) 

fpmr{s,d} 

reg2, reg3, <effective address>, 

regl 

regl(-operand) + (reg3 * reg2) 

fpmr{s,d} 

reg4, reg2, reg3, regl 


regl ^ (-reg3) + (reg2 * mg4) 

fpmrs 

<eal>, reg2, <ea2>, regl 


regl <— (-operand2) + (reg2 * operandl) 

1_ 



J 


is equivalent to the following sequence of instructions: 


r 



fpmul3s 

dO, fpal, temp 


fpsub3s 

fpa2, temp, temp 


fpmoves 

temp, fpa3 




_ ) 


In single-precision extended form either the first and third operands or the second 

and third operands can be effective addresses. Note that, for example, 

fpmrs do, fpal, fpa2, fpaS 

V_^ 


The f pam instruction, where a stands for add, and m stands for multiply, can 
be generalized as 


r 


> 

fpamt 

X, fpax, fpay, fpaw 


1 


J 


where f is s or d, and X is an <ejfective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 
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/- 

Instruction 


A 

Meaning 

fpam{s , d} 

<ejfective address>, reg2, regS, 

regl 

regl reg3 * (reg2 + operand) 

fpam{s,d} 

reg2, reg3, <effective address>, 

regl 

regl <— operand * (reg3 + reg2) 

fpam{s , d} 

reg4, reg2, reg3, regl 


regl <— reg3 * (reg2 + reg4) 

fpams 

<eal>, reg2f <ea2>, regl 


regl <— operand2 * (reg2 + operand 1) 

_^ ^J 


In single-precision two-memory instructions, either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 


( - 



fpams 

fpal, fpa2, fpa3, fpa4 


v_ 


J 


is equivalent to the following sequence of instructions: 


( - 

fpadd3s 

fpal, 

fpa2, 

temp 


fpmul3s 

temp, 

fpa3. 

temp 


fpmoves 

temp, 

fpa4 


j 


The f psm instruction, where s stands for subtract, and m stands for multiply, 
can be generalized as 


f 


N 

fpsmr 

X, fpax, fpay, fpan 


V_ 


J 


where r is s or d, and X is an effective address or one of the floating-point data 
registers. In the extended type of instruction, the positions of X and fpay can 
be exchanged. The special cases for single-precision instmctions are that either 
the first and third operands or the second and third operands can be effective 
addresses. 


r - 

Instruction 


Meaning 


fpsm{s,d} 

<ejfective address>, reg2, reg3. 

regl 

regl <— reg3 * (reg2 - operand) 


fpsm{s,d} 

reg2, reg3, <ejfective address>, 

regl 

regl <— operand * (reg3 - reg2) 


fpsm{s,d} 
fpsm{s,d} 

reg4, reg2, reg3, regl 
reg2, <ejfective address> , reg3, 

regl 

regl <— reg3 * (reg2 - reg4) 
regl <— reg3 * (-reg2 + operand) 


fpsm{s,d} 

fpsms 

fpsms 

V_ 

reg2, reg4, reg3, regl 
<eal>, reg2, <ea2>, regl 
reg2, <eal>, <ea2>, regl 


regl ^ reg3 * (-reg2 + reg4) 

regl <— operand2 * (reg2 - operand 1) 

regl <— operand2 * (-reg2 + operand 1) 

J 


Note that, for example. 


/- 

fpsms do, fpal, fpa2, fpa3 


V 

_7 


is equivalent to the following sequence of instructions: 
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fpsubSs dO, fpalf temp 

fpmulSs temp, fpa2, temp®' 
fpmoves temp, fpa3 


C.7. Other Instructions Other special instructions are listed below. In each of them the last operand is 

also the destination, except for tst, cmp and mcmp where fpastatus is 

the implied destination. X is either an effective address or an FPA data register 
and t is either s or d for all instructions except f pmover, where t can be s, 

d, or 1. 


Table C- 1 Other Instructions 


Mnemonic 

Operand 

Operation Name 

fpnop 


nop 

fptstr 

X 

operand compare with zero 

f pcmpr 

X, fpam 

register m compare with operand 

f pmcmpr 

X, fpam 

register m compare magnitude with operand 

fpmovet 

fpam, fpan 

move floating-point register 

fpmove2t 

fpam, fpan 

2x2 matrix move 

f pmoveSr 

fpam, fpan 

3x3 matrix move 

f pmove4r 

fpam, fpan 

4x4 matrix move 

fpdot2r 

fpax, fpay, fpan 

fpan <— f pax*fpay (fpax+i) * (fpay+i) 

fpdotSr 

fpax, fpay, fpan 

fpan fpax*fpay (fpax+i) * (fpay+i) + 

(fpaxi<-2) * (fpay-f2) 

fpdot 4r 

fpax, fpay, fpan 

fpan <— fpax*fpay (fpax-/-i)*(fpay-f i) + 
(fpax+2)*(fpay'+2) (fpax-f5)*(fpay+5) 

fptran2r 

fpam, fpan 

transpose 2x2 matrix 

fptranSf 

fpam, fpan 

transpose 3x3 matrix 

fptran4t 

fpam, fpan 

transpose 4x4 matrix 

fpmove 

fpamode, <ea> 

read mode register 

fpmove 

<ea>, fpamode 

write to mode register 

fpmove 

fpastatus, <ea> 

read status register 

fpmove 

<ea> , fpastatus 

write to status register 

fpmove/ 

fpam, <ea> 

read a floating-point data register 

fpmove/ 

<ea>, fpan 

write to a floating-point data register 


C.8. Restrictions and In double-precision instructions, when absolute short addressing or a single data 

Errors or address register is used, as reports an invalid operand error. 

For the dot product and matrix move and transpose instructions, when the regis¬ 
ter specified does not fall within the specified range, as reports a register-out- 
of-range error. 
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For most instructions where one operand is an effective address, the register 
range is 0 to 15. If all operands are FPA registers, then the register range is 0 to 
31. For constant RAM registers, the range is 0 to 511. as reports an invalid 
operand error when any of these registers are not within the permitted range. 


C.9. Instruction Set 

Summary 


In the following table, X is any valid MC68020 or MC68030 effective address 
(the form (xxx) i w is not allowed for double) or FPA register. In some three- or 
four-address instructions the position of the X and one of the FPA registers can 
be exchanged. This is shown in the fourth column of the following table. 


Table C-2 Floating-Point Instructions 



Operand 

Operation 

Alternative 

fpnegs 

X, fpan 

negate single 


fpnegd 

X, fpan 

negate double 


fpabss 

X, fpan 

absolute value single 


fpabsd 

X, fpan 

absolute value double 


fpltos 

X, fpan 



fpltod 

X, fpan 

convert integer to double 


fpstol 

X, fpan 

convert single to integer 


fpdtol 

X, fpan 

convert double to integer 


fpstod 

X, fpan 

convert single to double 


fpdtos 

X, fpan 

convert double to single 


fpsqrs 

X, fpan 

square single 


fpsqrd 

X, fpan 

square double 


fpadds 

X, fpan 

add single 


fpadd3s 

X, fpam, fpan 

add single 

fpa/n, X, fpan 

fpaddd 

X, fpan 

add double 


fpaddSd 

X, fpa/n, fpan 

add double 

fpa/n, X, fpan 

fpsubs 

X, fpan 

subtract single 


fpsubSs 

X, fpa/n, fpan 

subtract single 

fpa/n, X, fpan 

fprsubs 

<ea>, fpan 

reverse subtract single 


fpsubd 

X, fpan 

subtract double 


fpsubSd 

X, fpa/n, fpan 

subtract double 

fpa/n, X, fpan 

fprsubd 

<ea>, fpan 

reverse subtract double 


fpmuls 

X, fpan 

multiply single 


fpmul3s 

X, fpa/n, fpan 


fpa/n, X, fpan 

fpmuld 

X, fpan 

multiply double 


fpmul3d 

Xr fpa/n, fpan 

multiply double 

fpa/n, X, fpan 



divide single 


fpdivSs 


divide single 

fpa/n, X, fpan 

fprdivs 

<ea>, fpan 

reverse divide single 

1 
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Table C-2 Floating-Point Instructions — Continued 


Ommtion 



fpcmps 

fpcmpd 

fpmcmps 

fpmcmpd 


fpsins 

fpsind 

fpcoss 

fpcosd 

fpatans 

fpatand 


fpetoxs 
fpetoxd 
fpetoxmls 
fpetoxmld 


fpsincoss 

fp 


f pmas 


fpmad 


fpmss 


fpmsd 


fpmrs 


fpmrd 


X, fpan 
X, fpam, fpan 
<ea>, fpan 



X, fpam 
X, fpam 

X, fpam 
X, fpam 



fpax, fpan 


fpa%, fpan 
fpajc, fpan 


fpax, fpan 
fpax, fpan 
fpax, fpan 


fpax, fpac:fpa5 

fp 


divide double 
divide double 
reverse divide double 


single compare with 0 
d ■' 


single compare 



single magnitude compare 
double magnitude compare 


sine single 
sine double 
cosine single 
cosine double 
atan single 
atan double 


ln(x) single 
ln(x) double 
ln(l+x) single 
ln(l+x) double 


fpac <— cosine(x), fpa^ <— sine (x) 
fpac <— cosme(x), fpa5 <— sine (x) 


fpan <— (fpax * X) + fpay 


X, fpax, fpay, fpan fpan <— (fpax * X) + fpay 


X, fpax, fpay, fpan fpan <— fpay - (fpax * x) 


X, fpax, fpay, fpan fpan <— fpay - (fpax * x) 


X, fpax, fpay, fpan fpan <— (fpax * x) - fpay 


X, fpax, fpay, fpan fpan ^ (fpax * x) -- fpay 


fpam, X, fpan 




♦s 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
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Table C-2 Floating-Point Instructions — Continued 


Instruction 

Operand 

Operation 


fpams 

X, fpax, fpay, fpan 

fpan <— (fpax + x) * fpay 





fpax, X, fpay, fpan 




fpay, fpax, X, fpan 




X, fpax, X, fpan 




fpax, X, X, fpan 

fpamd 

X, fpax, fpay, fpan 

fpan <— (fpax + x) * fpay 





fpax, X, fpay, fpan 




fpay, fpax, X, fpan 

fpsms 

X, fpax, fpay, fpan 

fpan <— (fpax - x) * fpay 





fpax, X, fpay, fpan 




fpay, fpax, X, fpan 




X, fpax, X, fpan 




fpax, X, X, fpan 

f psmd 

X, fpax, fpay, fpan 

fpan <— (fpax - x) * fpay 





fpax, X, fpay, fpan 




fpay, fpax, X, fpan 

fpmovGs 

<ea>, fpan 

write to a register, single 


fpmoved 

<ea>, fpan 

write to a register, double 


fpmovel 

<ea>, fpan 

write to a register, integer 


fpmoves 

fpa/n, <ea> 

read a register, single 


fpmoved 

fpam, <ea> 

read a register, double 


fpmove2 s 

fpa/n, fpan 

2x2 matrix move, single 


fpmove2d 

fpa/n, fpan 

2x2 matrix move, double 


fpmoveSs 

fpa/n, fpan 

3x3 matrix move, single 


fpmoveSd 

fpa/n, fpan 

3x3 matrix move, double 


fpmove4s 

fpa/n, fpan 

4x4 matrix move, single 


fpmove4d 

fpa/n, fpan 

4x4 matrix move, double 


fpdot2s 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax-/-/) * (fpay-f/) 


fpdot2d 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax-/-/) * (fpay-f/) 


fpdotSs 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax-f/) * (fpay-f/) -t- 




(fpaXT»-2) * (fpayT<-2) 


fpdotSd 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax-f/) * (fpay-f/) -I- 




(fpax-f 2) * (fpay-f 2) 


fpdot4s 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax+Z) * (fpayii-/) + 




(fpax-f2) * (fpay-f2) + (fpax-f5) * (fpay-f5) 


fpdot4d 

fpax, fpay, fpan 

fpan <— fpax*fpay + (fpax-f/) * (fpay-f/) + 




(fpax-f2) * (fpay-f2) + (fpax-f5) * (fpay-fJ) 


fptran2 s 

fpa/n, fpan 

transpose 2x2 matrix, single 


fptran2d 

fpa/n, fpan 

transpose 2x2 matrix, double 


fptranSs 

fpa/n, fpan 

transpose 3x3 matrix, single 


fptranSd 

fpa/n, fpan 

transpose 3x3 matrix, double 


fptran4s 

fpa/n, fpan 

transpose 4x4 matrix, single 


fptran4d 

fpa/n, fpan 

transpose 4x4 matrix, double 
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Table C-2 Floating-Point Instructions — Continued 


Instruction 

Operand 

Operation 

Alternative 

fpmove 

fpamode, <ea> 

read the mode register 


fpmove 

<ea>, fpamode 

write on mode register 


fpmove 

fpastatus, <ea> 

read the status register 


fpmove 

<ea>, fpastatus 

write to status register 



Table C-3 FPA+ Instructions 

The original FPA used the Weitek 1164/1165 floating-point chip set The newer FPA+ is based on the TI 8847 chip, 
and supports floating-point operations on variables of complex type, and square root. The new complex math instruc¬ 
tions operate only on double precision values. 

You can see examples of floating point coprocessor usage in /usr/lib/f 68881, /usr/lib/f fpa, and 
/usr/ lib/f fpaplus. 


Instruction 

Operand 

Operation 

fpsqrts 

fpsqrtd 

dO, fpan 

dO:dl,fpan 

square root 

fphypots 

fphypotd 

al@, fpam, fpan 
a0@, fpam, fpan 

hypoteneuse 

fpcnegd 

a0@,fpan 

complex negation 

fpcabsd 

a0@,fpam 

complex absolute value 

fpcaddd 

a0@,fpam,fpan 

complex add 

fpcsubd 

a0@,fpam, fpan 

complex subtraction 

fpcmuld 

a0@, fpam, fpan 

complex multiply 

fpcdivd 

a0@,fpam,fpan 

complex division 
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-m68020, 1 
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assignment statements, 18 thru 19 
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basic elements, 5 thru 9 
.bss directive, 24 
.byte directive, 23 
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character set, 5 
code 

self-modifying, 19 thru 20 
. comm directive, 26 
co mm ent field, 18 
constants, 7 thru 8 
decimal, 7 
floating-point, 8 
hexadecimal, 7 
numeric, 7 
octal, 7 
string, 8 
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-d2 option, 2 
. data directive, 24 
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direct assignment, 18 thru 19 
directives, 21 thru 28 
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. Icomm, 25 
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Error Codes, 37 
. even directive, 27 
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external, 12 thru 13 
operators, 11 
relocatable, 12 thru 13 
terms, 12 

external expressions, 12 thru 13 
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floating-point constants, 8 
FPA Assembler Syntax, 65 thru 72 
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. globl directive, 26 

H 

-h option, 2 

hexadecimal constants, 7 
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identifiers, 5 thru 6 
Instruction Syntax, 65 
Instructions, Two-Operand, 66 

J 

- j option, 2 

K 

“k option, 1 

L 

-L option, 2 
label field, 15 thru 16 
labels, 6 thru 1 
local, 6 
numeric, 6 
scope, 6 

. Icomm directive, 25 
lexical elements, 5 thru 9 
lines, 15 
local labels, 6 
location counter, 8 
. long directive, 23 

M 

--m68010 option, 1 
-m68020 option, 1 

N 

notation, 2 thru 3 
numeric constants, 7 
numeric labels, 6 

o 

-o option, 1 
octal constants, 7 
operand field, 17 thru 18 
Operand Types, 66 
operation code field, 16 thru 17 
options, 1 thru 2 
-k, 1 
-d2, 2 
-h, 2 
"•j, 2 
-L, 2 

-m68010, 1 
-m68020, 1 


options, continued 
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-R, 1 

P 

. proc directive, 28 
program layout, 15 thru 19 
pseudo-ops, 21 thru 28 
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. ascii, 22 
.asciz, 23 
. bss, 24 
. byte, 23 
. conun, 26 
. data, 24 
. even, 27 
. globl, 26 
. Icomm, 25 
. long, 23 
. proc, 28 
. skip, 25 
. text, 24 
. word, 23 

R 

-R option, 1 

register operands, 17 thru 18 
address registers, 30 
data registers, 30 
special registers, 31 
Register Syntax, 66 
relocatable expressions, 12 thru 13 
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scope of labels, 6 
self-modifying code, 19 thru 20 
• skip directive, 25 
special register operands 
cc, 31 
dfc, 31 
fpcr, 31 
fpiar, 31 
fpsr, 31 
pc, 31 
sf c, 31 
sp, 31 
sr, 31 
usp, 31 
statements, 15 

comment field, 18 
direct assignment, 18 thru 19 
label field, 15 thru 16 
operand field, 17 thru 18 
operation code field, 16 thru 17 
string constants, 8 
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.text directive, 24 
Two-Operand Instructions, 66 
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Usage Errors, 37 
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.word directive, 23 
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